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PREFACE 


The RSX-11D Executive Reference Manual provides information required 


to prepare user programs written in MACRO-1l Assembler Language for 
execution under the RSX-11D Operating System. It touches only briefly 
on preparing FORTRAN programs, because the FORTRAN Special Subroutines 
Reference Manual covers this material. 


The manual is organized as follows. 


Chapters 1 and 2 present overview information, first on the whole 
RSX-11D system, then on the RSX-11D Executive, respectively. Details 
on the philosophy of RSX-11D can be obtained by reading the 
introductory chapters of the RSX-11D User's Guide. 


Chapters 3 and 4 deal with specific Executive functions and how to use 
them. 


Appendixes A, B and C cover system list formats, a glossary, and a 
summary of the file QIOMAC.MAC. QIOMAC.MAC provides all symbolic 
values for QUEUE I/O function codes as well as symbolic definitions 
of status return codes. Appendix D contains directive parameter block 
formats for the directives. 


1x 


CHAPTER 1 


INTRODUCTION 


RSX-11D is an event-driven multiprogramming operating system with 
features that make it appropriate for a wide range of applications 
involving real-time operations. RSX-11D provides the basis’ for 
process control systems, online business systems, and communications 
systems, 
The modular construction of RSX-11D allows the user to configure 
available hardware and software resources to fit a particular 
processing requirement. The use of memory partitions and priority 
scheduling facilitates user control over the execution of many 
parallel real-time functions. 
RSX-11D features include: 

Fast interrupt response and servicing, 

Simultaneous monitoring of multiple activities, 

250 priority levels for task execution, 

Priority servicing of I/O requests, 

Convenient storage and recall of disk-resident programs, 

Efficient, convenient task scheduling facilities, 

Dynamic memory partitions to contain tasks of varying sizes, 

Event flags for task synchronization and notification, 

Checkpointing (roll-in/roll-out), a form of memory sharing, 


Online program development, concurrent with task execution, 


FORTRAN, COBOL*, and MACRO-11 programming languages’~= and 
utilities, 


Asynchronous execution of I/O-dependent code, 
Support of multiuser programs and re-entrant code, 
Dynamic shared global areas. 


*Separate license 


1.1 SYSTEM EXECUTIVE SOFTWARE 


The following paragraphs provide a brief description of RSX=-11D 
software. 


1.1.1 Tasks 
The basic program unit under RSX-11D is called aé_ task. A task 
consists of one or more programs that have been written in FORTRAN or 
MACRO-1l1 Assembly Language. Relocatable object modules are generated 
and installed into the system online, making them available in 
memory~image format on the disk. A task can initiate another task's 
execution in various ways. The following are examples: 

1. Request immediate execution, 

2. Request execution contingent upon available memory, 


3. Schedule at a future time, with optional rescheduling at 
periodic intervals. 


All these task initiation functions can be accomplished from an 
operator's console as well as from a currently executing task. 


1.1.2 Memory Management 
There are three basic functional uses for which memory is allocated. 
The amount of memory allocated to each function is specified by the 
user at SYSGEN time. 
The three functional memory areas follow. 

l. RSX-11D Executive code. 


2. Partitions space for tasks and shared global areas. 


a. User-controlled partitions in which only one task or 
shared global area can occupy the partition at a time 


b. System-controlled partitions in which the Executive 
controls allocation of memory in the partition and allows 
multiple tasks or shared global areas within the 
partition at one time 


3. System lists and system tables. 


1.1.3 Significant Events and System Traps 


RSX-11D is an event-driven system in which task execution is governed 
by the occurrence of significant events. A significant event is any 
change in system status that affects the execution of a task. For 
example, completion of an I/O operation is a significant event. 


One of the ways that significant events are signalled is through event 
flags. There are 64 event flags. Flags 1 through 32 are local to the 
task, while event flags 33 through 64 are common to all tasks. A task 
can set, clear, test, and wait for any event flag or combination of 
event flags, to achieve efficient synchronization between itself and 
other tasks in the system. 


When a significant event occurs, the Executive scans an active task 
list, described in Chapter 2, seeking the highest priority task that 
can be executed. When an eligible task is found, it is run until it 
exits, suspends execution, waits for a significant event, ora 
significant event occurs. 


System traps are another means of governing task execution. While 
significant events have a system-wide scope, traps are local to a 
task. Traps interrupt the sequence of instruction execution in the 
task and cause control to be transferred to a prespecified point in 
the program. Traps can be either synchronous or asynchronous. 


Synchronous system traps (SSTs) allow servicing of fault conditions, 
such as memory protection violation, that can occur internally in a 
task. 


Asynchronous system traps (ASTs) are executed as the result of 
Significant events. Because the task has no control over when the 
significant event is to occur, ASTsS execute asynchronously with 
respect to the task. 


Trap service routines may or may not be provided by the user to handle 
the synchronous and asynchronous’ traps. If no synchronous trap 
service routine is provided, the faulting task is aborted. If no 
asynchronous trap service routine is provided, the task continues to 
execute without interruption. 


1.1.4 System Directives 


System directives are instructions to RSX-11D to perform functions for 
an executing task. System directives allow tasks to perform the 
following: 


Schedule other tasks, 
Communicate with other tasks, 
Measure time intervals, 
Perform I/O functions, 
Suspend execution, 

Exit. 


Directives are generated by MACRO-1l programs via macro calls and are 
supported for FORTRAN by library routines supplied by DIGITAL. Refer 
to Chapter 3 of this manual for details of directive usage in MACRO-11l 
programs. 


1.2 DEVICE HANDLERS 


Device Handlers are tasks that support I/O devices. These tasks are 
similar to normal tasks within the system with the following 
additional features: 


They usually contain an interrupt service routine 
to respond to hardware interrupts, 


They are allowed to gain access to any memory 
areas including privileged ones. 


By convention, device handler task names consist of two alphabetic 
characters followed by four dots. For example, the line printer 
handler is named as follows. 


LPs sv 


Device handler tasks are loaded into memory on command from the 
operator as needed. Requests from user tasks are queued by the 
Executive to the device handler according to the priority of the I/O 
request. If no priority is specified, that of the requesting task is 
used by default. When necessary, however, the requesting task can 
reserve a device for its exclusive use for a period of time by 
attaching it using the ATTACH function. 


CHAPTER 2 


RSX-11D EXECUTIVE 


This chapter acquaints the user with the basic design elements of the 
RSX-11D Executive. It is not intended to provide the detail required 
by a systems programmer for modification of RSX=-11D. 


The primary functions of the Executive include memory and disk 
Management, Supervision of task execution and scheduling, intertask 
communication, I/O queuing, console command monitoring, and 
Maintenance of system integrity. 

The basic program unit under RSX-11D is called a task and consists of 
a program or set of programs that have been written in FORTRAN and/or 
MACRO-11 assembly language. Relocatable task modules are created 
either online or offline and are installed into an RSX-11D system. 


This process results in the recording of the task on the system disk 
in memory image form; i.e., the task is in executable form. 


2.1 MEMORY MANAGEMENT 


There are three different functional memory spaces. The size of each 
is specified during system generation. These areas are; 


1. The Executive, 

2. Partitions, 
a. System-controlled partitions 
b. User-controlled partitions 


3. System communication area (SCOM). 


2.1.1 Partitions 


Partitions are areas of contiguous real memory that are used for task 
execution. There are two modes of partition usage: user-controlled 
where only one task at a time can occupy the partition and 
system-controlled where the system controls allocation of memory 
within the partition for execution of one or more tasks. The name, 
base address, size, and mode of each partition are specified during 
system generation and cannot be changed online. Tasks are installed 
to run in a particular partition but, upon specific request, can run 
in any partition that is large enough. 


Normally, an active task remains resident in its memory space until 
its execution is completed. A checkpointable task, however, can be 
forced to relinquish its memory for execution of a higher priority 
task. 


2.1.2 Shared Global Areas 


Shared global areas (libraries, global common blocks, and pure areas 
of multiuser tasks) require space in partitions. They can be fixed in 
memory or can be assigned memory by the Executive when tasks that use 
them are activated. 


Libraries normally are read-only and are used for code. 


Global common blocks can be addressed on a per=-task basis as 
read/write or read-only. This is a characteristic of the task rather 
than the global area and is specified during task building. The 
global area includes FORTRAN COMMON space and, normally, is used for 
intertask exchange of large amounts of data. SEND and SEND AND 
REQUEST also can be used to exchange small amounts of data among 
tasks. They should not be used for large amounts of data. 


Multiuser tasks consist of a pure area and an impure area. The pure 
area of multiuser task is the area that is not modified during task 
execution and can be shared among multiple versions of the task. The 
impure area changes during execution; one copy of the impure area 
exists for each simultaneous user of the task. 


2.1.3 System Communication Area (SCOM) 


This memory space contains the tables, lists, system subroutines, and 
other information required by the Executive to perform its functions 
and maintain control of the system. It consists of a number of fixed 
tables or lists and code, with the remaining space being available in 
variable-length nodes. These nodes are used by the Executive and for 
intertask communication. 


2.2 CONTROL OF TASK EXECUTION 


RSX-11D is event-driven, in contrast to systems which use a time slice 
mechanism for determining a task's eligibility to execute. Under 
RSX-11D, the highest priority task can run continuously until some 
event or condition in the system causes it to be suspended. Another 
event or change in system status can reactivate the task. 


Tasks can be activated either by the operator or by another. task. 
Activation can be conditional, based on currently available partition 
space (EXECUTE), or it can occur as soon as possible (REQUEST). Also 
it can occur as soon as possible after some future time (SYNC, 
SCHEDULE, and RUN). 


2.2.1 Multiprogramming 


Effective multiprogramming is achieved when many tasks reside in 
memory simultaneously, spending some of their residency waiting for 
I/O completion, waiting for synchronization with other tasks, or in 
some way being unable to continue execution. While one or more tasks 
are waiting, another task can utilize the central processor's 
resources. 


Under RSX-11D, tasks are run at a software priority level ranging from 
a low of 1 through a high of 250. The Executive grants central 
processor resources to the highest priority task capable of execution. 
When a task becomes ready to execute and it has a higher priority than 
the currently executing task, the Executive interrupts the lower 
priority task and allows the higher priority task to run. Execution 
of the interrupted task continues when it once again becomes’ the 
highest priority task capable of execution. The environment of an 
interrupted task is preserved; except for elapsed time, interruption 
is transparent to an interrupted task. 


This multiprogramming scheme normally applies only to memory-resident 
tasks. Once a task is in memory, the Executive allows it to run to 
completion in a multiprogramming fashion even if its memory becomes 
required for the execution of a higher priority, non-resident task. 
However, if it is desirable to free memory for execution of a higher 
priority task, a task can be declared checkpointable when it is task 
built. A checkpointable task is swapped out when its memory is 
required for a higher priority task and swapped in when it once again 
becomes the highest priority task requiring its memory. 


Normally, a task is brought into memory when requested, executes, and 
is removed from memory upon completion. This process frees memory for 
another task to execute. However, a task can be fixed in memory to 
permit faster response to requests for its execution. It remains in 
the partition until it is explicitly removed by an UNFIX directive. 
Tasks fixed in a _ system-controlled partition have no effect on the 
rest of the partition which remains available for execution of other 
tasks. 


2.2.2 Significant Events 


A task is considered active from the time its execution starts until 
the time it has exited. While the task is active, it is included ina 
priority~ordered list of active tasks called the active task list 
(ATL). The system uses the ATL in the following way. 


When a significant event is declared, the Executive interrupts the 
executing task and scans the active task list examining the status of 
tasks until a task capable of execution is found. Execution of that 
task is then initiated, or continued, until one of the following 
occurs. 


l. The task exits. 
2. The task must wait for another event (e.g., I/O completion). 


3. A significant event occurs and a higher priority task is 
capable of execution. 


Task switching occurs as a result of a significant event, and 
significant events occur only when declared explicitly or implicitly 
by tasks. 


NOTE 
Task switching occurs 
implicitly when a lower 


priority task is eligible for 
execution and the currently 
executing task performs one of 
the following actions: 


Suspends itself, 

Waits for an event 
(e.g., I/0 completion), 
Exits. 


Event flags are associated with significant events. Declaration of a 
significant event indicates that something has happened in the system, 
and the possible setting of a particular event flag indicates what has 
happened. For example, upon completion of I/O requests, a device 
handler task normally sets a requester-indicated event flag and 
declares a significant event. If a requesting task instructs the 
system that it cannot run until an event flag is set (signalling task 
I/O completion), other eligible tasks of lower priority may run. In 
the scan of the active task list, a task that is awaiting I/0 
completion is by passed until a significant event is declared through 
the setting of a event flag upon task I/O completion. 


Each task has access to 64 event flags of which 1 through 32 are 
unique to each task and 33 through 64 are common to all tasks. The 
use of event flags is detailed in Chapter 4. 


2.2.3 System Traps 


The ability to service certain conditions without continuously testing 
for their existence is provided via system traps. As discussed in 
Chapter 1, two types of traps are defined: synchronous and 
asynchronous (also see Chapter 4). A trap is a linkage method for 
optional in-task service routines. Service routines must be included 
as a part of the task, limited by the same restrictions as the task, 
and run at the task's priority as a result of a system trap condition, 
(e.g., fault, I/O completion). This facility also provides a means of 
responding to the execution of privileged instructions and non-RSX-11D 
EMT's, 


If the system is not explicitly notified of the existence of a system 
trap service routine, the system trap does not occur. 


2.3. SYSTEM TABLES AND SYSTEM LISTS 


RSX-11D uses linked lists and fixed-length tables to maintain system 
information. Fixed-length tables are lists with elements that reside 
in consecutive memory locations. This format is used when lists are 
static, when list scan time is critical, or both. 


Most linked lists are linked as double-ended queues and are called 
deques (pronounced "“decks"). Deques allow list elements to be added 
or deleted from either end, since they include backward and forward 
pointers. An RSX-11D deque consists of a listhead and list elements 
(nodes), circularly linked by both backward and forward pointers. The 
first word of a node (or listhead) is a forward pointer, i.e., the 
address of the next node (or listhead) looking forward. The second 
word of a node (or listhead) is a backward pointer, i.e., the address 
of the next node (or listhead) looking backward. 


A listhead is a node that consists of only a forward and a backward 
pointer, and is used as a reference point. Hence, a listhead 
identifies a deque, and indicates both the beginning and end of the 
circularly linked list. All nodes are a multiple of eight words in 
length. Usually the first two words contain pointers and the third 
defines the node's owner. The following paragraphs describe the major 
lists used in RSX-11D. Their formats and contents are described in 
Appendix A. 


2.3.1 Clock Queue 


The clock queue is a linked list with its listhead in SCOM. It 
consists of one node for each operation to be performed at some time 
in the future. A ticks-till-due count in the first node of the clock 
queue is decremented at each clock tick until the node becomes due 
(i.e., until the count is zero). Then the indicated operation is 
performed. The nodes are linked in the order in which they come due. 
Each node is 16 words. 


2.3.2 I/O Request Queue 


The I/O request queue is a linked list with a listhead in the physical 
unit directory entry for the unit to which the request has been 
queued. Each entry is 16 words. 


2.3.3 Global Common Directory 


The global common directory (GCD) is a linked list of entries for each 
global common block and library installed in the system. The GCD 
listhead is in SCOM. Each entry is 16 words. 


The GCD entries are created by INSTALL for the pure area of multiuser 
tasks and for global common areas (libraries and global common). GCD 
entries are linked into the GCD at run time and are pointed to by the 
task's STD. 


2.3.4 Physical Unit Directory 


The physical unit directory (PUD) is a table of entries for each 
physical unit specified during system generation. When a logical unit 
number is assigned to a physical unit, the physical unit is 
represented by the address of the corresponding PUD entry. Each entry 
is 25 words. 


2.3.5 System Task Directory 


The system task directory (STD) is a table that provides information 
about each task installed in the system. The information recorded in 
a task's STD entry includes the following: 


1. Information required when the task is not active (viz., 
receive linked list listhead), . 


2. Information required to load a task into memory (viz., task 
name, disk address of image). 


Under RSX-11D, tasks are referred to by name, and the STD is’ searched 
for an indicated task name at each reference. The STD is structured 
to enable this search to be performed rapidly, without imposing naming 
conventions, order of installation, or the dedication of a large 
memory area. 


The STD consists of a table of entry pointers (alpha table) for the 
Maximum number of installed tasks and a 16-word entry for each task 
that is installed. The table is maintained by the programs that 
install and remove tasks such that the number of entries is known and 
consecutive table words point to task STD entries ordered 
alphabetically by task name. Thus, a task name can be found rapidly 
using a binary search and memory is not dedicated for STD entries 
until it is needed. The maximum size of the STD is specified during 
system generation. 


The 16-word block of memory for an STD entry is taken from the _ pool 
when a task is installed and returned when a task is removed. 


2.3.6 Send/Receive Queues 


The send/receive queues are linked lists with listheads in the STD 
entries for each task. Entries are created and queued in priority 
order by the SEND directives and removed by the RECEIVE directives. 
Entries are variable in length up to 255 words. 


2.3.7 Task Partition Directory 


The task partition directory (TPD) is a table of entries for each task 
partition defined during system generation. Each entry is 10 words. 


2.3.8 Node Pool 


A node is a block of memory that is a multiple of eight words in 
length. Empty nodes for use in any deque are initially provided by 
the system generation routine in the form of a long block called the 
pool. When a node is needed to expand a list, it is taken from the 
pool. When a node is no longer needed, it is returned to the pool. 


2.3.9 Interrupt Connect Node 


Interrupt connect nodes connect the trap vector to the interrupt 
service routine of a device handler task. Each node is 16 words. 


2.3.10 Memory Required List (MRL) 


The memory required list is a priority-ordered linked list of active 
task list nodes for active tasks that require memory in a partition. 
Its listhead is in the task partition directory (TPD). There is an 
MRL for each partition. Whenever a nonfixed task exits, the MRL 
associated with that partition is scanned, and an attempt is made to 
assign memory to the highest-priority task in the list. If the 
attempt is successful, the task's node is moved from the MRL to the 
active task list. Each node is 24 words. 


2.3.11 Checkpointable Task List (CTL) 


For each partition, there is a priority-ordered list of checkpointable 
tasks that are active in that partition. Actually, this list is a set 
of links threaded through the ATL and not a distinct physical set of 
nodes. The CTL listhead is in the TPD. Each entry is 24 words. 


2,3.12 Fixed Task List (FTL) 


The fixed task list (FTL) is a deque of active task list nodes for 
tasks that have been fixed in memory but are not active. The FTL 
listhead is in SCOM,. When a fixed task is made active, its node is 
relinked from the FTL to the ATL. When the task exits it is relinked 
into the FTL, Each node is 24 words. 


2.3.13 MCR Command Buffer 


The MCR command buffer is 96-byte buffer that holds the data for a 
requested MCR function task. The buffer is set up by the MCR dispatch 
task. The nodes required for the buffer are returned to the pool 
after the GET MCR COMMAND LINE directive passes the command line to 
the MCR function task. 


2.3.14 Batch Command Buffer 


The batch command huffer is a 96-byte buffer that holds data for the 
batch processor. It functions in the same manner as the MCR command 
buffer. 


2.3.15 Asynchronous System Trap Queue 


The asynchronous system trap queue (ASQ) is a linked list that 
operates on a first-in/first-out basis. Its listhead is in ATL 
entries. It consists of one node for each AST (asynchronous system 
trap) to be executed for the task as defined by the STD entry. Each 
node is eight words. 


2.4 I/O OPERATIONS 


The Executive's main function in I/O operations is to handle I/O 
requests from tasks and pass the requests to the appropriate device 
handler task. The general method follows. 


1. A QIO directive (see Chapter 3) is issued by a task. 
The task specifies a number of parameters that are 
required in processing the I/O request. One of 
these parameters is the logical unit number (LUN) 
assigned to a device by the task. 


The directive is issued by means of a normal 
software emulated trap. It follows the normal 
PDP~1l trap sequence. 


2. The Executive examines the LUN parameter of the QIO 
directive to determine which device handler is to 
process the request. The particular device handler 
is chosen by mapping the LUN of a particular task 
into an entry in the physical unit directory using 
the logical unit table. 


3. The I/O request is put in the request queue of a 
device handler (one of a set of special tasks). 


The requesting task can either suspend operation until the I/O request 
is completed or continue to operate until interrupted by an 
asynchronous system trap (see Chapter 4). RSX-11D permits parallel 
I/O requests to be issued by the same task. That is, the task 
continues executing after issuing a QIO; subsequently the task can 
issue further QIO requests without waiting for the previous request to 
be completed. 


Some device handlers operate in conjunction with the file control 
primitives (FCP) to manipulate files. When an FCP routine is 
required, the device handler issues a SEND/REQUEST which initiates 
operation of the specified FCP routine. 


I/O requests are queued for each unit by priority at requester task 
priority unless otherwise specified. The handler tasks pick requests 
from the top of request queues. Thus, preferential service is given 
to high priority requests. However, when appropriate, devices can be 
attached to a task, in which case only requests from the attached task 
or express request are dequeued, This continues until a 
detach-unit-from—-task request is dequeued, causing requests to be 
dequeued by priority from the top of the I/O request queue once again. 


The right to attach and detach devices is controlled by access 
privileges defined for each device. Requests to attach a device are 
rejected if the requester does not have the proper access’ rights. 
Because device handler tasks can service many units, they are not 
themselves attached. 


The interface between a device handler task and the RSX-11D system is 
accomplished by directives and system subroutines which attach and 
detach devices and dequeue I/O requests. 


CHAPTER 3 


SYSTEM DIRECTIVES 


3.1 INTRODUCTION 


System directives are instructions to the Executive to perform an 
indicated operation. The applications programmer uses them to control 
the execution and interaction of tasks. The system macro library 
contains macro calls, which the programmer can use to execute 
directives. The FORTRAN programmer invokes system directives through 
a subroutine call, as described in the FORTRAN Special Subroutines 
Reference Manual. 


Directives are implemented solely through the EMT 377 instruction. By 
using only EMT 377, programs using EMT 0 through EMT 376 can be run 
via a non-RSX system trap. Any EMT other than EMT 377 traps to a 
task-contained service routine that can be written to simulate another 
environment to whatever degree is desired. 


By using macro calls, instead of executing the directive, the 
programmer need only reassemble his program if changes are made in the 
directive specifications, rather %1:. being required to edit the 
source code, 


3.2 DIRECTIVE IMPLEMENTATION 
A brief discussion of how directives are implemented will help the 
programmer understand and use the macro calls associated with the 
directives. 
Directive processing consists of five parts. 
1. The user issues a directive. The directive identifier and 
the directive parameters are placed in the directive 
parameter block (DPB). 


The DPB can either be on the stack or be in the user task 
space, 


2. An EMT 377 is issued. 


3. The Executive traps the instruction and performs three steps: 
l. Determines whether the instruction is an EMT 377. 
2. If it is a 377, transfers it to the directive processor. 


3. If it is not a 377, determines whether user is capable of 
handling the directive. If yes, user is given control. 
If not, an error is returned. 


4. The Executive processes the directive. 


5. The Executive returns to the issusing task through "common 
exit," if necessary, and processes any system events. 


The EMT 377 is issued with the address of a directive parameter block 
(DPB), or a DPB itself, on the top of the issuing task's stack. When 
the stack contains a DPB pointer (address), the pointer is removed 
(popped) after the directive is processed. When the stack contains a 
DPB, the entire DPB is removed as the directive is processed. In 
either case, the DPB is not altered when the directive is processed. 


With the exception of EXIT directives, control is returned to the 
instruction following the EMT, with the C_ condition code set or 
cleared and the directive status word (DSW) set to indicate 
performance or rejection. The DSW is at virtual location zero of each 
task. 


In the case of EXIT directives, control is not returned, but the C 
condition code and DSW are set. 


When a directive is performed properly, the C condition code in the PS 
(CC-C) is cleared and the directive status word (DSW) contains a 
positive number, unless otherwise noted in the directive description. 
When a directive is rejected, the C condition code is set and the DSW 
contains a negative number. The number's value indicates the reason 
for rejection. 


The first word of all DPB's contains a directive identification code 
(DIC) byte and a DPB size byte. The DIC indicates which directive is 
to be performed. The size byte indicates the DPB length in words. 
The DIC is in the low-order byte of the word and the size is in the 
high-order byte. 


3.3 CONVENTIONS 


The following conventions and assumptions are standard for all 
directives. 


l. Task and partition names can be up to six characters 
long and are always represented as two words in 
radix-50 form. 


2. Device names are two characters long and are 
represented by one word in ASCII form. 


3. Time unit indicators, used for initial and repeated 
requests, are 1 for clock ticks, 2 for seconds, 3 
for minutes, and 4 for hours. 


4. The term "background task" indicates a task that is 
initiated from batch, 


3.4 ERROR RETURNS 


Directive rejections are divided into two classes: those where a 
programmed recovery would be common and those where it would be 
unlikely. The error code, always negative, is returned in the DSW at 
virtual location 0. Rejections with expected programmed recoveries 
(i.e., where a branch is taken to an error routine) have values 
between -l1 and -19. Error codes indicating errors for which 
programmed recoveries are not feasible are in the range from =-20 
through -99. 


The error codes that can be received for a particular directive are 
listed with the individual directive descriptions. 


3.5 USING THE DIRECTIVE MACROS 


This discussion applies to MACRO-11 programs. FORTRAN programmers 
should refer to the FORTRAN Special Subroutines Reference Manual for a 
description of the library subroutines which support the directives 
for that language. 


Directives are issued by including appropriate macro calls in the 
program. Macro names consist of up to four letters followed by a 
dollar sign and, optionally, one letter. The optional letter 
specifies which of three possible expansions of the macro is desired. 


If the optional letter is S, the macro produces code to push a DPB 
onto the stack, followed by an EMT 377. 


If the optional letter is omitted, the macro produces only the 
directive's DPB, The macro expansion is inserted at the point of 
macro invocation, but it does not contain executable code. 


When the user uses the $ or $C form of the macro call, specifying the 
generation of a DPB at assemble time, it is assumed that the 
parameters required for DPB construction are valid expressions to be 
used in MACRO-1l data storage instructions (e.g., .BYTE, .WORD, 
«RADSO). 


If, however, the $S form is used, specifying the generation of code to 
store the DPB in the stack, the parameters must be valid source 
operands to be placed directly in MOV instruction. 


Only the $S form produces the DPB dynamically. The other two forms 
produce the DPB at assembly time. 


If the user has a predefined DPB, i.e., has used the $ or $C form of 
the macro, and wishes to avoid the creation of another one, the DIRS 
macro should be used instead of one that identifies the function. 
This macro pushes the DPB address onto the stack using MOV SSS,-(SP), 
where the macro parameter (shown here as SSS), is any valid 
representation of the DPB address. The instruction is followed by EMT 
377. 


In addition to the macro routines that correspond to the directives, 
the DIRS macro is useful to the programmer, particularly in cases 
Where the DPB has been defined independently of the execution of the 
directive. 
DIR$ generates an RSX-11D Executive trap with a predefined DPB. 

ijacro Call: DIR$ adr,err 


Three forms are possible, with the following interpretation: 


DIRS Assumes that the address of the DPB or the 
DPB itself has already been pushed onto the 
stack. 

DIRS$ adr Generates the code to push the parameter adr 


onto the stack. 


DIRS adr,err Generates the code to push the parameter adr 
onto the stack, executes an EMT 377, 
generates a branch on carry clear to the 
address of the branch +4 (or +6 if 
necessary) and generates a JSR PC to the err 
address. 
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The argument adr is optional but, if present, must be a valid 
assembler source operand used to push the DPB address onto the stack. 


The argument err is optional. If defined, it must be a valid 
assembler destination operand to permit a Jump to Subroutine (JSR) 
instruction to an error handler if the directive is rejected. 


If the optional letter is C, the macro generates a DPB in a_ separate 
program section, called S$DPB$$. The DPB is followed by a return to 
the original program section, an instruction to push the DPB address 
onto the stack, and an EMT 377. To ensure that the correct program 
section is re-entered, the user must specify its name in the argument 
list immediately following the required DPB parameters. If the 
argument is not specified, the blank (unnamed) program section is 
assumed, 


The $C form of the macro call accepts an optional argument, PSECT. 
This argument allows return to the PSECT specified rather than to the 
default PSECT. 
The $C and $S forms of macro calls and DIR$ accept an optional final 
argument. If included, the argument must be a valid assembler 
destination operand to call a user error routine. The argument 
generates the following code. 

OPENSW #FDBADR,,,,,,OPEERR 

BCC +6 7;BRANCH ON DIRECTIVE ACCEPTANCE 

JSR PC,OPEERR s;ELSE, CALL ERROR SERVICE ROUTINE 


This option is ignored when the user specifies the generation of the 
DPB only. 


3.5.1 Symbolic Offsets 


Most system directive macro calls generate local symbolic offsets. 
The symbols are unique to each directive and are assigned the values 
of the byte offset from the start of the directive's DPB to the DPB 
elements. 


Because the offsets are defined symbolically, the programmer who must 
refer to or modify DPB elements can do so without calculating the 
offsets. Symbolic offsets also preclude the necessity of rewriting 
programs to accommodate changes. in DPB specifications. 


All $ and $C forms of macros that generate DPB's longer than one word 
generate local offsets. All informational directives, including the 
$S, form generate local symbolic offsets for the parameter block in 
question. 


If any of the $ or $C forms of the macros is invoked and the user 
defined symbol S$SGLB is included, the DPB is not expanded, 
Furthermore, if the macro produces symbolic offsets, they are 
generated as global symbols, unless previously defined. The symbol 
S$$$GLB has no effect on the expansion of $S macros. 


3.5.2 Examples of Macro Calls 


1. MRKTS 1,5,2,MTRAP [generate DPB only in current PSECT] 
~BYTE 23¢50% 3;"MARK=TIME” DIC AND DPB SIZE 
«WORD 1 ;EVENT FLAG NUMBER 
«WORD 5 ;TIME INTERVAL MAGNITUDE 
«WORD 2 s;TIME INTERVAL UNIT 
»WORD MTRAP ;AST ENTRY POINT 


2. MRKTS$C 1,5,2,MTRAP,PROG1,ERR [generates DPB in separate PSECT] 


«PSECT SDPBS$ 
$$$=. ;DEFINE TEMPORARY SYMBOL 

BYTE 23.,5. ;"MARK TIME" DIC AND DPB SIZE 

«WORD 1 ;EVENT FLAG NUMBER 

e WORD 5 ;TIME INTERVAL MAGNITUDE 

«WORD 2 ;TIME INTERVAL UNIT 

e WORD MTRAP ;AST ENTRY POINT 

ePSECT PROG] {return to the original PSECT] 

MOV #$$$,-(SP) ;PUSH DPB ADDRESS ON STACK 

EMT 377 ;TRAP TO THE MONITOR 

BCC +6 ;BRANCH ON DIRECTIVE ACCEPTANCE 

JSR PC,ERR ;ELSE, CALL ERROR SERVICE ROUTINE 
3. MRKTSS #1,#5,#2,R2,ERR [push DPB onto stack] 

MOV R2,~- (SP) 3;PUSH AST ENTRY POINT 

MOV #2 ,-(SP) ;TIWE INTERVAL UNIT 

MOV #5 ,~ (SP) ;TIME INTERVAL MAGNITUDE 

MOV #1,-(SP) 7;EVENT FLAG NUMBER 

MOV (PC)+,-(SP) ;AND MARK TIME" DIC & DPB SIZE 

EMT 377 ;TRAP TO THE MONITOR 

BCC +6 BRANCH ON DIRECTIVE ACCEPTANCE 

JSR PC,ERR 7;ELSE,CALL ERROR SERVICE ROUTINE 
4. DIR$ @R1, (R3) [DPB already defined. DPB address in Rl.] 

MOV @R1,- (SP) ;PUSH DPB ADDRESS ONTO STACK 

EMT 377 ;TRAP TO THE MONITOR 

BCC «+4 ;BRANCH ON DIRECTIVE ACCEPTANCE 

JSR PC, (R3) s;ELSE, CALL ERROR SERVICE ROUTINE 


3.6 DIRECTIVE SUMMARIES 


Each directive description consists of a narrative explanation of its 
function and use, the name of the macro associated with it and its 
parameters, and the possible ::-" irn values of the directive status 
word (DSW), which is virtual memory location zero. 


Only the $ form of the macro name is given, although all three options 
are available unless otherwise specified. 


The directive descriptions are presented in alphabetic order by macro 
call for ease of reference. However, the directives can be 


categorized according to their function. Table 3-1 lists the 
directives by function and describes them briefly. 


Table 3-1 
RSX-11D Directives 


ASSOCIATED 
DIRECTIVE MACRO CALL FUNCTION 


DIRECTIVE DIRS Generates an RSX-11D trap with a 
co DPB. 

Task Execution 

Control 


| EXECUTE EXECS Executes a task only if sufficient 
memory is available at the present 
time. If memory is not available, the 
request is not queued. 
REQUEST ROSTS Runs a task contingent upon priority 


i 


and memory availability. If the task 
cannot be run immediately, the request 
is queued. 


Requests a task using the RQOSTS 
directive at a specific future time 
and, optionally, repeats the request 
periodically; e.g., the request can 
be scheduled for 11:35 a.m. 


SCHEDULE 
Requests a task using the  RQSTS 
directive at a specified interval from 
the current time and, optionally, 


RUN RUNS 
repeats the request periodically. 
SYNCHRONIZE SYNCS$ Requests a task using RQST$ at a 
specific interval from a_ specified 
future time and, optionally, repeats 
the request periodically. 


CANCEL SCHEDULED CSRQS$ Cancels scheduled requests for task 

REQUESTS executions. 

SUSPEND SPNDS Suspends execution of the task issuing 
the directive. 
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DIRECTIVE 


TASK EXIT 


ABORT TASK 


Task Status Control 


FIX IN MEMORY FIX$ 


UNFIX 


| DISABLE 


EWABLE 


Table 


RSX-11D Directives 


ASSOCIATED 
MACRO CALL FUNCTION 


| RESUME RSUMS 


EXITS 


ABRTS$ 


UFIXS 


DSBL$ 


ENBLS 


DISABLE DSCP$ 
CHECKPOINTING 


ENABLE 
CHECKPOINTING 


ALTER PRIORITY 


Informational 
Directives 


GET COMMON BLOCK 
PARAMETERS 


GET PARTITION 
PARAMETERS 


GET TASK PARAMETERS 


GTSK$ 


GCOM$ 


GPRT$ 


Resumes the execution of a task that 
has suspended itself. 


Terminates execution 
issuing the 


significant event. 


directive 


the task 


and 


causeS a 


Terminates execution of another task. 


Fixes in memory 


(makes 


permanently 


resident) an inactive, installed task. 


Negates a FIX$ directive and frees the 
Inmemory allocated to the task. 


Rejects future attempts to execute 


or 


fix an indicated task using any of the 


following directives: 


RQSTS, 


SCHD$, RUNS, SYNC$, or FIXS$. 


Makes a specified 
capable of being run, 


Disables the 
issuing task. © 


Makes the issuing task 
was 


if checkpointing 
disabled. 


disabled 


Alters the priority of the 


active task 


to the 


new 


indicated in the directive. 


Fills an indicated 8-word buffer with 


information for a 


block, 


Fills an indicated 3-word buffer with 
information for a specific partition. 


specific 


EXECS, 


task 


checkpointability of the 


checkpointable 
previously 


specified 


priority 


comnon 


Fills an indicated l16-word buffer with 


information about the task issuing the 
directive. 


Table 3-1 (Cont.) 
RSX-11D Directives 


ASSOCIATED 
MACRO CALL FUNCTION 


GET SENSE SWITCHES Obtains the status of the console 
sense switches and stores it in the 
issuing task's directive status word. 


GET LUN GLUNS Fills a 6-word buffer with information 
about a physical unit to which the 
task is assigned 

| Byentzassociated 

| Byentzassociated 


DECLARE SIGNIFICANT Declares a significant event and, 
optionally, sets an event flag and 
reports the status of the flag before 
it was set. DECL$ causes an ATL scan. 


Sets an indicated event flag and 
reports the status of the flag before 
it was set. SETF$ does not cause a 
significant event. 


Clears an indicated event flag and 
reports the flag's status before 
clearing. CLEF$ does not cause a 
significant event. 


READ EVENT FLAG Reads a specified event flag and 
indicates by the return code in the 
directive status word whether the flag 
is set or cleared. 

READ ALL FLAGS RDAFS$ Reads all 64 event flags and records 
their status by ecte? or clearing 
corresponding bits a 64-bit 
(4-word) buffer. 


WAIT FOR SINGLE Suspends execution of the issuing task 
EVENT FLAG until the indicated event flag is set. 


WAIT FOR LOGICAL OR Suspends execution of the issuing task 
OF FLAGS until any indicated event flag in one 
of five groups is set. 


WAIT FOR Suspends execution of the issuing task 
SIGNIFICANT EVENT until the next significant event 
occurs. 


Terminates the execution of the 
issuing task if an indicated event 
flag is not set. 


Table 3-1 (Cont.) 
RSX-11D Directives 


ASSOCIATED 
MACRO CALL FUNCTION 
Trap~Associated 
Directives 
flag also can be set when the 


mae significant event is declared, 


CANCEL MARK TIME Cancels any mark time requests made by 
REQUESTS the issuing task. 

INHIBIT AST 
RECOGNITION 


ENABLE AST 
RECOGNITION 


Declares a significant event after an 
indicated time interval starting at 
issuance of the directive. An event 


Inhibits recognition of asynchronous 
system traps for the issuing task. 


Recognizes asynchronous system traps 
for the issuing task. 

Tells the system whether or not power 
recovery AST's are desired for the 
issuing task. If desired, this 
directive indicates where control is 
to be transferred when the AST occurs. 


SPECIFY POWER 
RECOVERY AST 


SPECIFY FLOATING 
POINT EXCEPTION AS 


Tells the system whether or not 
PDP=11/45 floating point exception 
AST's are desired for the task. If 
desired, the directive indicates where 
control is to be transferred when the 
AST occurs. 


SPECIFY RECEIVE AS Allows a task to determine whether 
another task has sent data to it 
without waiting for an event flag or 
continually checking the buffer. When 
data is detected, an AST is executed. 


SPECIFY SST VECTOR 
TABLE FOR DEBUGGING 


Specifies the virtual address of a 
table of synchronous system trap 
service routine entry points for use 
by ODT or other debugging aids. SVDB$ 
takes precedence over SVTKS. 

SPECIFY SST VECTOR Specifies the virtual address of a 
table of synchronous system trap 
service routine entry points for use 
by the issuing task. 


TABLE FOR TASK 


TERMINATE AST 
EXECUTION 


Terminates execution of an 
asynchronous system trap service 
routine. 


Table 3-1 (Cont.) 
RSX-11D Directives 


ASSOCIATED 
| DIRECTIVE =— | MACRO CALL CALL} SCSCSFUNCTION 
I/O Related 
Directives 
QUEUE I/0 Places an I/O request for an indicated 
device in a priority-ordered queue of 
requests for that unit. 
QUEUE I/O AND WAIT Performs the functions of both WTSES 
(see above) and QIOS. 
ASSIGN LUN Assigns a logical unit number (LUN) to 
a physical device unit. . 
VSDA$ Queues a variable-length data block by 
priority for a task to receive. 


SEND DATA 


VSDR$ Queues a variable-length data block 
by priority for a task to receive and 


SEND DATA AND 
RESUME OR 
REQUEST RECEIVER 


resumes or requests execution of the 
receiving task. 


RECEIVE DATA VRCD$ Receives a variable-length data block 
that was queued by another task. 


Receives a variable-length data block 
that has been queued by another task 
or exits if none is queued, 


RECEIVE DATA OR VRCS§$ Receives a variable-length data block 
SUSPEND if one is queued for the task or 
suspends the task. 


GET MCR COMMAND Transfers an 80-byte command line to 
LINE the issuing task. 


RECEIVE DATA OR 
EXIT 


NOTE 
For Information About: Refer To: 
SDATS VSDAS 
SDRQS$ VSDR$ 
RCVD$ VRCD$ 
RCVX$ VRCX$ 


3.6.1 SEND and RECEIVE Directives 


The following additional information about SEND and RECEIVE directives 
should be noted. 


l. 


2. 


3. 
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Variable-length data up to 255 words can be sent and 
received. 


If the receiver's buffer is too small to hold all the data 
sent, the excess is lost and the receiver is notified by an 
error code in the directive status word (DSW). 


The TI of a task is the same as the TI of the terminal from 
which the task was initiated. If the task was initiated by 
another task, the TI of the requesting task becomes the TI of 
the requested task also. 


Certain directives can be issued only to affect tasks with 
the same TI: RESUME, ABORT TASK, ALTER PRIORITY, and CANCEL 
SCHEDULED REQUEST. 


Multiuser tasks issuing receive directives are passed only 
that data sent with the same TI as the multiuser task. This 
approach ensures the proper flow of data among. several 
multiuser tasks and a single-user task when the single-user 
task is receiving from and sending to the multiuser tasks. 


Up to three data words can be transmitted in a single 8-word 
node; the other five words are used for SEND/RECEIVE 
overhead. 


The default buffer length (13 words) requires a 24-word node, 
rather than 16 words. 


ABRTS 


aT ABRT$ (ABORT TASK) 


The ABORT TASK directive terminates the execution of the indicated 
task. This directive is intended for use as an emergency exit or 
fault exit. It causes a printout at the console each time it is 
invoked, A task can abort any other task. If the task being aborted 
is a multiuser task, it is aborted only if its TI matches that of the 
task issuing the ABORT directive. ABORT TASK cannot be issued by a 
background task. 


Macro Call: ABRTS$ task 
task = Task name. 


The following symbol is locally defined with its assigned value equal 
to the byte offset from the start of the DPB to the DPB element. 


A.BTTN = (Length is 4 bytes) Task name 
DSW return codes: 


+1 <= Successful completion 
-02 -- Task not installed 
-07 -- Task not active 
-08 -=- Task loading or exiting 
-10 -<-- Task is not abortable 
-80 <-- Directive issued by background task 
-98 -- Part of DPB is out of issuing task's address space 
-99 -=- DIC or DPB size is invalid 


Macro Expansions: 


AR2TS  YOUFS 
eafiYTe 83.5 
eFANSG S/YVIRSS 


ALTPS 


3.8 ALTP$ (ALTER PRIORITY) 


The ALTER PRIORITY directive alters the priority of the specified 
active task to the new priority indicated in the directive, If the 
task is multiuser, its priority is altered only if its TI matches that 
of the calling task. 


Macro 


task = 


pri = 


Call: ALTPS task,pri 


the name of the task whose priority is to be changed. 
If task is not specified, the calling task's priority 
is changed to its default priority. 


the new priority (1-250) for the task. If pri is not 
specified, the new priority is the priority specified 
at task build or installation. If a priority was not 
specified during task build or installation, a system 
default of 50 (decimal) is used. 


The following symbols are defined locally with their 
assigned values equal to the byte offset of the DPB. 


A.LTTN = task name (4 bytes) 


A.LTPR = priority (2 bytes) 


DSW return 
+1 - 
-07 = 


codes: 


- Successful completion 
- Task not installed 
- Task not active 


-08 -=- Task in process of being loaded or exiting 


- Directive issued by background task 
- Invalid priority 


-“98 << Part of DPB is out of issuing task's address space 


Macro Expansion: 


AL TPS 
ot VTE 
oF ANH 
ae fyRety 


TESXIZ, 1A 
S.p4 
STARK YS 
1c a 


ALUNS 


3.9 ALUNS (ASSIGN LUN) 


The ASSIGN LUN directive assigns a logical unit number (LUN) to a 
physical device unit. 


Macro Call: ALUN$ lun,devnam,devnum 


lun = Logical unit number 
devnam = Physical device name (two characters) 
devnum = Physical device unit number 


If devnam and devnum are omitted, the LUN is assigned as null. If it 
has previously been assigned, omitting devnam and devnum deassigns the 


LUN. 


The following symbols are locally defined with their assigned values 
equal to the byte offset from the start of the DPB to the respective 


DPB elements. 


A.LULU = (Length 2 bytes) logical unit number 
A.LUNA (2) Physical device name 
A. LUNU (2) Physical device unit number 


DSW return codes: 


+01 <-- Successful completion 

“90 -- LUN usage interlocked (via file open) 

-92 <-- Invalid device and/or unit 

“96 <-- Invalid logical unit number 

“98 <= Part of DPB is out of issuing task's address space 
“99 -<-- DIC or DPB size is invalid 


Macro Expansion: 


AL LING y,LP 0 
eaYTE 7,4 

o VIR) 5 
eASCTIO Sts 
eASCIT s/Ps 

eV V2 4 


ASTX$ 


3.10 ASTXS$ (AST SERVICE EXIT) 


The AST SERVICE EXIT directive terminates execution of an asynchronous 
system trap service routine. ASTs are described in Section 4.2. 


If another AST is queued, and ASTs are not inhibited, the next AST is 
executed. Otherwise, the task's pre-AST state is restored, 


When an AST service routine is entered, the stack contains certain 
information. This information is required because the AST routine 
runs with the sane ATL node, task header, and DSW as the main part of 
the task. Those portions of control areas that can be used to effect 
requests from AST service routines are saved on the stack. The 
following information is on the stack. 


SP+14 -- Event flag mask word for flags 1-16 

SP+12 <-- Event flag mask word for flags 17-32 

SP+10 <= Event flag mask word for flags 33-48 

SP+06 -= Event flag mask word for flags 49-64 

SP+04 -=- The pre-AST task's program status (PS) 
SP+02 -- The pre-AST task's program counter (PC) 
SP+00 -- The pre-AST directive status (virtual zero) 
Additional parameters, if any 


The stack can contain additional information as well. For power 
recovery AST's, no information is added, but for I/O done the stack 
contains the address of the I/O status’ block; for MARK TIME, the 
Stack contains the event flag number; and for an 11/45 floating point 
exception, the stack contains the exception code, and the exception 
address. 


AST service routines must save and restore all registers used. 


The AST service routine must remove any information on the stack that 
is additional to the seven words shown above before issuing an AST 
SERVICE EXIT directive. The following example shows how this is done 
when an AST routine is used on I/O completion: 


;MAIN BODY OF PROGRAM 
START: . 7PROCESS 


QIO$S #IO.WVB,#2,,,#IOSTBK, #ASTSER, <#BUFFER, #60. ,#40> 
; ;PROCESS & WAIT 


EXITS$S 7EXIT TO MONITOR 


IOSTBK: .BLKW 2 
BUFFER: .BLKW 60. 


;AST SERVICE 
ASTSER: 


TST (SP) + ;REMOVE ADDR OF I/O STATUS BLOCK 
ASTX$S sAST EXIT MACRO 


Macro Call: ASTXS$ 
DSW return codes: 


+01 -- Successful completion 

-80 <-- Directive not issued from an AST service routine 

“98 -= Part of DPB or table is out of task's address 
space 

-99 <-- DIC or DPB size is invalid 


Macro Expansion: 


ASTXS 
2ayvTe 115.,1 


CLEF$ 


3.11 CLEF$ (CLEAR EVENT FLAG) 
The CLEAR EVENT FLAG directive clears an indicated event flag and 
reports the flag's polarity before clearing in the DSW. Clearing an 
event flag does not cause a significant event. 

Macro Call: CLEFS efn 

efn = Event flag number 


The following symbol is locally defined with its assigned value equal 
to the byte offset from the start of the DPB to the DPB element. 


C.LEEF = (Length 2 bytes) event flag number 
DSW return codes: 


+00 -<- Flag was already clear 

+02 <-- Flag was set 

-97 == Event flag number <1 or 64 

-98 -- Part of DPB is out of issuing task's address 
space 

-99 -=- DIC or DPB size is invalid 


Macro Expansion: 


CLEFS 4 
emyTte 31.72 
ek WW 4 


CMKTS 


3.12 CMKTS (CANCEL MARK TIME REQUESTS) 


The CANCEL MARK TIME REQUEST directive cancels MARK TIME requests that 
have been made by the issuing task. If no parameters are supplied 
with the macro call, all MARK TIME requests that have been made by the 
issuing task are cancelled. Parameters are specified to cancel only 
Mark time requests that set an indicated event flag or cause an AST at 
an indicated location. 


Macro Call: CMKTS$ efn,ast 


efn = event flag number (0 implies no event flag) 
ast = AST service routine entry address 


The following symbols are locally defined with their assigned values 
equal to the byte offset from the start of the DPB to respective DPB 
elements. 


C.MKEF = (length 2 bytes) Event flag number 
C.MKAE = AST service routine entry address 


DSW return codes: 


+1 -=- Successful completion 

-~90 ~- No EFN or AST entry specified 

~97 -- Invalid event flag number (event flag number <1 or 
>6 4) 

-~98 -- Part of DPB is out of issuing task's address space 

~99 -- DIC or DPB size is invalid 


Macro Expansion: 


emeTs 3,CMTAST 
eat TE 27, $ 

ew eh 5 

0 WIR) a’“Tast 


CSRQ$ 


3.13 CSRQS$ (CANCEL SCHEDULED REQUESTS) 


The CANCEL SCHEDULED REQUESTS directive cancels scheduled requests for 
task executions. All requests to run a specified task can be 
cancelled, or only those issued for a specified task by another 
specified task. If the task to be cancelled is a multiuser task, it 
is cancelled only if its TI matches that of the scheduler. This 
directive cannot be issued by a background task. 


Macro Call: CSRQ$ ttask,rtask 


ttask = Scheduled (requested) task name, 
rtask = Scheduler (requester) task name, 


The following symbols are locally defined with their assigned values 
equal to the byte offset from the start of the DPB to the respective 
DPB elements. 


C.SRTN = (length 4 bytes) target task name 
C.SRRN = (4) Requester task name 


The issuing task is taken as the scheduler task when not specified. 
DSW return codes: 


+1 -=- Successful completion 

-02 <- Task not installed 

-80 -- Directive issued by background task 

-98 -- Part of DPB is out of issuing task's address space 
“99 += DIC or DPB size is invalid 


Macro Expansion: 


CE275 T4S4£1,T4ASKA 
et ¥Y¥TE Dee S 

er ADS STASELS 

of 4052 STASK AS 


DIRS 


3.14 DIRS (DIRECTIVE) 
DIR$ generates an RSX-11D Executive trap with a predefined DPB. 
Macro Call: DIR$ adr,err 


Three forms are possible, with the following interpretation: 


DIR$ assumes the address of the DPB or the DPB 
itself has already been pushed onto the 
stack. 

DIR$ adr generates the code to push the parameter adr 


onto the stack. 


DIR$ adr,err generates the code to push the parameter adr 
onto the stack, executes an EMT 377, 
generates a branch on carry clear to _ the 
address of the branch +4 (or +6 if 
necessary) and generates a JSR PC to the err 
address, 


The argument adr is optional but, if present, must be a valid 
assembler source operand used to push the DPB address on the stack. 


The argument err is optional. If defined, it must be a valid 
assembler destination operand to permit a jump to subroutine (JSR) 
instruction to an error handler if the directive is rejected. 


Macro Expansion: 


NIRS #A 
ALY #4,"@(5P) 
REMY 377 


DECL$ 


3.15 DECLS (DECLARE SIGNIFICANT EVENT) 


The DECLARE SIGNIFICANT EVENT directive declares a significant event 
and, optionally, 


was set. Declaring a significant event causes a scan of the active 
task list (ATL). 


sets an event flag and reports its state before it 


The directive performs four functions: 


Tests an event flag, 

Sets the event flag, 

Declares a significant event, 

Reports the flag's polarity prior to being set in the 


DSW. 


Macro Calls DECLS$ efn 


efn = event flag number (an event flag number of 0 implies 
no event flag number) 


The following symbol is locally defined with its assigned value equal 
to the byte offset from the start of the DPB to the DPB element. 


D.CLEF = (Length 2 bytes) event flag number 


DSW return codes; 


+1 
+0 
+2 
-97 
-98 
-99 


Macro Expansion: 


DECLS 
eevVtr 
eh ORD 


No event flag specified 

Specified flag was cleared 

Specified flag was set 

Event flag number <1 or 564 

Part of DPB is out of issuing task's address space 
DIC or DPB size is invalid 


aa 
35.00 
ain 
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DSBLS$ 


3.16 DSBL$ (DISABLE) 


The DISABLE directive instructs the system to reject future attempts 
to run or fix an indicated task (REQUEST, EXECUTE, SCHEDULE, RUN, 
SYNCHRONIZE, and FIX-IN-MEMORY directives). It is used effectively to 
remove a task from a system without actually deleting its STD entry. 
DISABLE cannot be issued by a background task. If the task to be 
disabled is active, it is not disabled until it becomes inactive. 


When a task is installed into a system, it is not disabled, i.e., it 
is runnable. 


Macro Call: DSBLS$ task 
task = Task name, 


The following symbol is locally defined with its assigned value equal 
to the byte offset from the start of the DPB to the DPB element. 


D.SBIN = (Length 4 bytes) task name 
DSW return codes: 


+1 -<- Successful completion 

-02 «- Task not installed 

-08 -- Task is already disabled 

-10 -- Task is not to be disabled 

“80 -- Directive issued by a background task 

-98 == Part of DPB is out of issuing task's address space 
~99 =m DIC or DPB size is invalid 


Macro Expansion: 
Sas HOTT 


otYTE OL. 8 
eSAUSR S/DITTS 


DSCP$ 


3.17 DSCP$ (DISABLE CHECKPOINTING) 


The DISABLE CHECKPOINTING directive disables the checkpointability of 
an issuing task that has been task built as being checkpointable,. 
This directive cannot be issued by a background task. 


When a checkpointable task's execution is started, checkpointing is 
not disabled, i.e., the task can be checkpointed. 


Macro Calls: DSCPS$ 
DSW return codes: 


+1 -< Successful completion 

-08 -=- Task checkpointing already disabled 

-10 - Issuing task not installed as checkpointable 

“80 -- Directive issued by a background task 

-98 --- Part of DPB is out of issuing task's address space 
-99 <-- DIC or DPB size is invalid 


Macro Expansion: 


ENARS$ 


3.18 ENARS (ENABLE AST RECOGNITION) 


The ENABLE AST RECOGNITION directive allows recognition of 
asynchronous system traps for the issuing task, i.e., nullifies an 
INHIBIT AST RECOGNITION directive. AST's that have occurred while 
recognition was inhibited are effected at issuance. When a task's 
execution is started, AST recognition is not disabled. ASTs are 
described in Section 4.2. 


AST service routines must save and restore all registers used. 
Macro Call: ENARS 
DSW return codes: 
+1 <-- Successful completion 
-08 -=- AST recognition not inhibited 
-98 -- Part of DPB is out of issuing task's address space 
“99 << DIC or DPB size is invalid 


Macro Expansion: 


ENARS 
e BYTE L7teel 


ENBLS 


3.19 ENBL$ (ENABLE) 


This directive instructs the system to make an indicated disabled task 
runnable, i.e., to nullify a DISABLE directive. ENABLE cannot be 
issued by a background task. 


When a task is installed into a system, it is not disabled, i.e., it 
is runnable. 


Macro Call: ENBL$ task 
task = Task name, 


The following symbol is locally defined with its assigned value equal 
to the byte offset from the start of the DPB to the DPB element. 


E.NBTN = (Length 4 bytes) Task name 
DSW return codes: 


+1 -=- Successful completion 

-02 -- Task not installed (No STD entry found) 

-08 -=- Task is not disabled 

-80 -=- Directive issued by a background task 

-98 -= Part of DPB is out of issuing task"'s address space 
-99 -=- DIC or DPB size is invalid 


Macro Expansion: 


FS3L3 0 TASKS? 
wFYTE © 934,68 
SELDSS TASKS A/ 


ENCPS 


3.20 ENCP$ (ENABLE CHECKPOINTING) 


The ENABLE CHECKPOINTING directive makes the issuing task 
checkpointable after its checkpointability has been disabled, i.e., to 
nullify a DISABLE CHECKPOINTING directive. Checkpoint cannot be 
enabled for a task that was not built as being checkpointable. 


Macro Call: ENCP$ 
DSW return codes: 
+1 <-- Successful completion 
-08 -- Checkpointing not disabled 
-80 -- Directive issued by background task 
“98 == Part of DPB is out of issuing task's address: space 
“99 <-- DIC or DPB size is invalid 


Macro Expansion: 


EMP Ss 
oP VTE Wael 


EXECS 


3.21 EXEC$ (EXECUTE) 


The EXECUTE directive activates a task only if the memory required for 
its execution is presently available. It cannot be issued by a 
background task. 


Macro Call: EXECS task,part,pri,ugc,upc 
task = Task name, 

part = Partition name, 

pri = Priority, 

ugc = UIC group code, 

upc = UIC programmer code, 


A partition cannot be specified for a multiuser task; i.e., the task 
must be requested to execute in its default partition. 


The following symbols are locally defined with their assigned values 
equal to the byte offset from the start of the DPB to the respective 
DPB elements. 


E.XCTN = (length 4 bytes) task name 
E.XCPN = (4) Partition name 
E.XCPR = (2) Priority 

E.-XCGC = (1) UIC group code 
E.XCPC = (1) UIC programmer code 


DSW return codes: 


+1 -- Successful completion 
-01 -- Insufficient pool nodes available to requester 
~02 -- Task not installed 
-03 -= No memory for execution 
~06 -- Handler task not resident to load task 
-07 -- Task is active 
-08 -- Task is disabled 
~80 -- Directive issued by background task 
~91 -=- invalid UIC 
-94 -- Partition not in system 
-95 -- Invalid Priority specified (<0 or >250) 
-98 -- Part of DPB is out of issuing task’s address space 
-99 == DIC or DPB size is invalid 


Macro Expansions: 


EXFOS AY PAZSK PART, $2,292,2A4% 
eoYTE 13,,7 

eFADSG SEVTASK/ 

eR ANSA SPARS 

eqn as 

oF VTE PAB, 2A 


EXIFS$ 


3.22 EXIF$ (EXITIF) 


The EXITIF directive terminates the execution of the issuing task if 
an indicated event flag is NOT set. Control is returned if the 
specified event flag is set. 


Macro Call: EXIF$ efn 
efn = event flag number 


The following symbol is locally defined with its assigned value equal 
to the byte offset from the start of the DPB to the DPB element. 


EeXFEF = (length 2 bytes) event flag number 


DSW return codes: 


+1 == Indicated event flag cleared, task exited 
+2 -- Indicated event flag set, task not exited 
-97 -=- No event flag specified in mask word(s), 
or invalid event flag number (event flag number <1 
or >64) 
-98 =-- Part of DPB is out of issuing task's address space 
-99 -= DIC or DPB size is invalid 


Macro Expansions: 


EXTFE 35 
oRYTe $3.7 
eR | 52 


EXITS 


3.23 EXIT$ (TASK EXIT) 
The TASK EXIT directive terminates the execution of the issuing task. 
Macro Call: EXITS 
DSW return codes: 
The DSW return codes can be tested only if the EXITS directive fails. 
+l <-- Successful completion 
-98 -- Part of DPB is out of issuing task's address space 


-99 -- DIC or DPB size is invalid 


Macro Expansion: 


EXTT$ 
oo Te Siert 


FIX$ 


3.24 FIX$ (FIX IN MEMORY) 


The FIX IN MEMORY directive fixes an inactive, installed task in 
memory. Once fixed in memory, the task cannot be checkpointed, and it 
does not relinquish its memory space until removed by the UNFIX 
directive. 


The use of this directive is desirable when the timing of a task's 
execution is critical, or when it is requested very frequently. when 
fixed, a fresh copy of the task is not loaded for each request. 
FIX+IN-MEMORY may not be issued by a background task. 


Macro Call: FIX$ task 
task = Task name, 


The following symbol is locally defined with its assigned value equal 
to the byte offset from the start of the DPB to the DPB element. 


F,IXTN = (length 4 bytes) task name 
DSW return codes: 


+1 -- Successful completion 
-01 -- Insufficient pool nodes available to requester 
-02 ~- Task not installed 
-03 -= Partition too small for task 
-706 == Handler task not resident to load task 
-07 -- Task is active 
-08 == Task is disabled 
-09 -- Task is already fixed 
-10 -- Task not fixable 
“ll -- Task is checkpointable 
~80 == Directive issued by background task 
~98 =~ Part of DPB is out of issuing task's address space 
-99 -= DIC or DPB size is invalid. 


Macro Expansion: 


FIX$ TASK? 
ee" YTE AS..3 
oF ADNSYA S/TASKAS 


GCOMS 


ees GCOM$ (GET COMMON BLOCK PARAMETERS) 


The GET COMMON BLOCK PARAMETERS directive fills an indicated 8-word 
buffer with common block parameters. 


The 8-word buffer is filled as follows: 


Wd. 00 
Wd. 01 
Wd. 02 
Wd. 03 
Wd. 04 
Wd. 05 
Wd. 06 
Wd. 07 


Macro Call: 


blknam = 


1/64th base address of common block 
1/64th size of common block 
Creation year 

Creation month 

Creation day 

Owner identification code (UIC) 
Starting ASR (APR) 

Common block flags byte (low order) 
and status byte (high order) 


GCOM$ blknam,bufadr 


Name of the common block 
bufadr = Adress of 8-word buffer 


The following symbols are locally defined with their assigned 
equal to the byte offset from the start of the DPB element. 


G.COBN = 


(4) 
(2) 


Common block name 
Buffer address 


value 


The following offsets are assigned relative to the start of the common 
block parameters buffer. 


G.COBB 
G.COBS 
G.COYR 
G.COMO 
G.COSA 
G.Courl 
G.COTP 
G.COFW 


The flags byte and 


(2) 
(2) 
(2) 
(2) 
(2) 
(2) 
(2) 
(2) 


the 


1/64 common black base address 
1/64 common block size 

Creation year 

Creation month and day 

Status and starting APR 

Owner identification (UIC) 

TPD 

Common block flags byte address 


status byte are in the same word (G.COFW). 


The 


flags byte is in the low-order position and the status byte is in the 
high-order position, 


The following bits are defined for the flags byte. 


Bit 


0 
1 
2 
3 
4 


Meaning When Set 


Library or common area loaded 
l =library, 0 = common area 
GCA is position independent 
Nonowner has write access 
Nonowner has read access 


The following values are defined for the status byte. 


Value Meaning 

0 Global area not in use 

2 Load request queued 

4 Load request succeeded 

6 Load request failed 
52 Record request queued 
54 Record request succeeded 
56 Record request failed 


DSW Status: 


+1 -- Successful completion 

-02 <-- Indicated common block not in system 

-98 -- Part of DPB or buffer is out of task's address 
space 

“99 == DIC or DPB size is invalid 


Macro Expansion: 


GCIMS SYSRES,COMBUF 
scY Te 57,,4 

eP405U S/SSYSRES/ 

20’ ORO CGOMSUF 
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GLUNS 


3.26 GLUN$ (GET LUN INFORMATION) 


The GET LUN INFORMATION directive fills a 6-word buffer with 
information about a physical unit to which the specified logical unit 
is assigned for the requesting task. If requests to the physical unit 
have been redirected to another unit, the information returned 
describes the effective assignment. 


The 6-word buffer of LUN information comprises the first six words of 
the PUD. See Appendix A. 


Macro Call: GLUN$ lun,bufadr 


lun = Logical unit number 
bufadr = Address of 6-word buffer which holds LUN 
information 


The following symbols are locally defined with their assigned values 
equal to the byte offset from the start of the DPB to the respective 
DPB elements. 


G.LULU - (length 2 bytes) Logical unit number 
G.LUBA = (2) Buffer address 


DSW return codes: 


+1 == Successful completion 
-05 <-- Unassigned LUN 
“96 = Invalid logical unit number 
“98 <-- Part of DPB or buffer is out of task's address 
space 
-99 = DIC or DPB size is invalid 


Macro Expansion: 


SLINS 3, LUNSUF 
et VTE 3,3 
aeRO 5 

e925 LUV IE 


GMCR$ 


3.27 GMCR$ (GET MCR COMMAND LINE) 


The GET MCR COMMAND LINE directive instructs the system to transfer a 
command line to the issuing task. The issuing task is an MCR function 
task requested by the MCR dispatcher task. The command line can be 1 
through 80 bytes in length. It was placed in a list in SCOM by the 
MCR dispatcher. The GMCR$ macro call should be issued as soon as 
possible by MCR function tasks (...xxx) in order to free pool space. 


If the command line is terminated by a carriage return, a flag is set 
in the task's header to cause the MCR dispatcher task to be requested 
upon exit. 


The command line is read into a buffer that is picked from the pool by 
the MCR dispatcher task. It is linked into the MCR queue or the batch 
queue by the batch processor. 


The format of the buffer is a standard MCR buffer. 


The DSW contains the character count for the command line excluding 
the carriage control characters if the directive executes 
successfully. 


Macro Call: GMCRS$ 


The following symbol is locally defined with its assigned value equal 
to the byte offset from the start of the DPB to the respective DPB 
element. 


G.MCRB = (Length 80 bytes) MCR line buffer 
DSW return codes. 
+nn -- Character count 
~80 -- No buffer exists or illegal task name 
-98 -- Part of DPB or buffer is out of issuing task's 
address space 
-99 =~ DIC or DPB size is invalid 


NOTE 


No "S$S" macro form exists for this 
directive. 


Macro Expansion: 


4S 
e3YTE 127,..41, 


GPRT$ 


3.28 GPRT$ (GET PARTITION PARAMETERS) 
The GET PARTITION PARAMETERS directive fills an indicated 3-word 
buffer with partition parameters. If a partition is not specified, 
the partition of the issuing task is assumed. 
The 3-word buffer is filled as follows: 

Wd. 00 <= 1/64th base address of partition 

Wd. Ol -- 1/64th size of partition 

Wd. 02 -= partition flags byte 

Macro call: GPRTS$ prtnam,bufadr 


prtnam = Partition name 
bufadr = Address of buffer 


The following symbols are locally defined with their assigned value 
equal to the byte offset from the start of the DPB to the DPB element. 


GePRPN - (4) Partition name 
G.PRBA = (2) Buffer address 


The following offsets are assigned relative to the start of the 
partition parameters buffer: 


G.PRPB — (2) 1/64 partition base address 
G.PRPS - (2) 1/64 partition size 
G.PRFW - (2) Partition flags byte 


The following bits are defined for the flags byte. 


Bit Meaning When Set 
0 User~-controlled partition 
1 Occupied user-controlled partition 
2 System-controlled partition 
3 Active system-controlled partition 


+0 -- Successful completion 

-02 -- Indicated partition not in system 

-98 -= Part of DPB or buffer is out of task's address 
space 

-“99 == DIC or DPB size is invalid 


Macro Expansion: 


GP2TS  GENFL,PARBUF 
enYTFe 68,,4 

eP ADS? /GENRLS 

2 A TR) PAaRSUIF 


GSSW$ 


3.29 GSSWS (GET SENSE SWITCHES) 


This directive instructs the system to get the status of the console 
sense switches and store it in the issuing task's directive status 


word. 
Macro call: GSSWS 


DSW Codes: 


Successful completion is indicated if CC-C is clear. Switch 
values will be found in the DSW. Unsuccessful completion is 
indicated by CC-C set and one of the following codes in the 


DSW. 


-98 ~~ Part of DPB is out of issuing task's address space 
-99 -— DIC or DPB size is invalid 


Macro Expansion: 


SESW 
oBYTE {25.,1 


GTIM$ 


3.30 GTIMS$ (GET TIME PARAMETERS) 


The GET TIME PARAMETERS directive fills an indicated 8-word buffer 
with current time and date parameters, All values are in binary. The 
8-word buffer is filled as follows. 


WD. 9 -- Year (since 1900), 

WD. 1 -- Month of year, 

WD. 2 “—— Day of month, 

WD. 3 -- Hour of day, 

WD. 4 “= Minute of hour, 

WD. 5 “= Second of minute, 

WD. 6 -- Tick of second, 

WD. 7 -— Ticks per second (depends on frequency of 


clock). 
Macro Call: GTIM$ bufadr 
bufadr = Address of 8—word buffer 


The following symbol] is locally defined with its assigned value equal 
to the byte offset from the start of the DPB to the DPB element. 


G.TIBA =: (length 2 bytes) Buffer address 


The following offsets are assigned relative to the start of the time 
parameters buffer. 


G.TIYR = (2) Year 

G.TIMO = (2) Month 

G.eTIDA = (2) Day 

G.TIHR = (2) Hour 

G.TIMI = (2) Minute 

G.TISC = (2) Second 

GeTICT = (2) Clock tick 

G.TICP = (2) Clock ticks per second 


DSW return codes: 


+1 -=- Successful completion 

-98 == Part of DPB or buffer is out of task's address 
Space 

-99 <-- DIC or DPB size is invalid 


Macro Expansions 
GTIMS TI MBUF 


ot Y¥Te 16052 
a KIRA TIMRUF = 


GTSK$ 


3.31 GTSK$ (GET TASK PARAMETERS) 


The GET TASK PARAMETERS directive fills an indicated l6-word buffer 
with parameters relating to the issuing task. 


The 16-word buffer is filled as follows: 


WD. 00 == Issuing task's name (first half), 

WD. 01 -=- Issuing task's name (second half), 

WD. 02 -=- Partition name (first half), 

WD. 03 -=- Partition name (second half), 

WD. 04 -= Name of the task to which the ATL 
node is accounted; usually task name of 
requester of issuing task (first half), 

WD. 05 -=— Name of the task to which the ATL node is 
accounted; usually task name of requester 
of issuing task (second half), 

WD. 06 == Run priority 

WD. 07 -=- User identification code (UIC for file 
control services) 

WD. 10 -- Number of logical I/O units (LUN's) 

WD. 11 -=- Machine type indicator e.g., 45, for PDP-11/45 

WD. 12 -=- STD flags words, 

WD. 13 -=- [Address of task SST vector tables], 

WD. 14 == [Size of task SST vector table (in words)], 

WD. 15 -- Zero (reserved) 

WD. 16 =-- Zero (reserved) 

WD. 17 -- Zero (reserved) 


Macro Call: GTSKS bufadr 
bufadr = Address of a 16<-word buffer. 


The following symbol is locally defined with its assigned value equal 
to the byte offset from the start of the DPB to the DPB element. 


G.TSBA = (length 2 bytes) Buffer Address, 


The following offsets are assigned relative to the start of the task 
parameters buffer: 


G.TSTN = (4) Task name, 
G.TSPN = (4) Partition name, 
G.TSRN = (4) Name of task's requester, 


G.TSPR = (2) Priority, 


G.TSGC = (1) UIC Group code 

G.TSPC = (1) UIC Programmer code 

G.TSNL = (2) Number of logical units, 

G.TSMT = (2) Machine type, 

G.TSFW = (2) STD flags word 

G.TSVA = (2) Task's SST vector address 
G.TSVL = (2) Task's SST vector (word) length 


The following bits are defined for the flags word. 
Meaning When Set 


Bit 
0 STD is 24 words long rather than 16 words long 
1 Task is fixed in memory 
3 Task is disabled 
4 Task is being fixed in memory 
6 Task is multiuser 
7 Task is privileged 
8 Network attribute bit 
9 Restricted usage level one (background batch jobs) 


10 Restricted usage level two 

ll Task cannot be aborted 

12 Task cannot be disabled 

13 Task cannot be fixed in memory 
14 Task cannot be checkpointed 


DSW: 


+01 -- Successful completion 

-98 -=- Part of DPB or buffer is out of task's address 
space 

~99 == DIC or DPB size is invalid 


Macro Expansion: 


B13K& TSKENF 
oSYTE 3,52 
e980 TSKRUF 


IHARS 


3.32 IHAR$ (INHIBIT AST RECOGNITION) 


The INHIBIT AST RECOGNITION directive inhibits recognition of 
asynchronous system traps for the issuing task. The AST's are queued 
as they occur and are effected when AST recognition is enabled. There 
is an implied AST inhibit whenever an AST service routine is 
executing. When a task's execution is started, AST recognition is not 
disabled. ASTs are described in Section 4.2. 


It is the recognition only which is inhibited. The ASTs are still 
queued by the system. They are queued FIFO and occur in that order. 


AST service routines must save and restore any registers used. 
Macro Call: IHAR$ 
DSW return codes: 
+1 <= Successful completion 
-08 =-- AST recognition already inhibited 


-98 =-- Part of DPB is out of issuing task's address space 
-99 -- DIC or DPB size is invalid 


Macro Expansion: 


THARS 
eAYTE 99.51 


MRKT$ 


3.33  MRKT$ (MARK TIME) 


The MARK TIME directive declares a significant event after an 
indicated time interval. The interval begins at issuance of the 
directive. If an event flag is specified, it is cleared at issuance 
and set at the time of the significant event, If an AST entry point 
is specified, an asynchronous system trap occurs at the time of the 
significant event, At the AST, the task's PS, PC, virtual zero 
(directive status), and the event flag mask are pushed onto the task's 
(user) stack. If neither an event flag number nor an AST service 
entry point is specified, the significant event still occurs after the 
indicated time interval. ASTs are described in Section 4.2. 


Macro Call: MRKT$ efn,timmag,timunit,ast 


efn = Aan flag number (0 implies no event 
lag) 
timmag 2 Time interval magnitude; i.e., how many time 
interval units 
timunit = Time interval unit 
1 = clock ticks 
2 = seconds 
3 = minutes 
4 = hours 
ast = AST entry address 


The following symbols are locally defined with their assigned values 
equal to the byte offset from the start of the DPB to the respective 
DPB elements. 


M.KTEF = (Length 2 bytes) event flag 
M.KTMG = (2) time magnitude 

M.KTUN = (2) Time unit 

M.KTAE # (2) AST entry address 


DSW return codes: 


+1 <= Successful completion 

-01 “= Unavailable pool node 

-93 +- Invalid time specified 

~97 -- Invalid event flag number (event flag number <1 or 
>64) 

“98 -=— Part of DPB is out of issuing task's address space 

~99 -=- DIC or DPB size is invalid 


Macro Expansions 


MRXTS 4,22,2,MTAST 
oBYTE 22455 


ewOoRD = 
WORD an 
weno 


.eORD | MTAST 


3-43 


Qio$ 


3.34 QIO$ (QUEUE I/O) 


The QUEUE I/O directive places an I/O request for an indicated device 
in a queue of priority-ordered requests for that device unit. The 
device unit is specified as a logical unit number (LUN). 


Normally, a significant event is declared by handler tasks (via system 
subroutines) upon I/O completion. If an event flag is specified, it 
is cleared when the request is queued, and set at the significant 
event. The I/O Status block is also cleared when the request is 
queued. 


If an AST service entry point is specified, the AST occurs upon I/0 
completion with the task's PS, PC, virtual zero (directive status), 
and the address of the I/O status block is pushed onto the task'’s 
(user) stack. Refer to Section 4.2. 


Macro Call: QI0$’ fnc,lun,efn,pri,iost,ast,prmlst 


fne = I/O function code (see Appendix C for symbols) 
lun = Logical unit number | 
efn = Event flag number (0 implies no event flag) 
It can be either global or local. 
pri = Priority 
iost = Address of I/O status block 
ast = Address of I/O done AST entry point 
prmlst = Parameter list of the form <Pl,....,P6> . 


Three error indicators are used in conjunction with QIOS: 
l. The C bit, 
2. The directive status word, 
3. The I/O status block. 


The C bit is set to indicate that the format of the macro call was 
incorrect; iee., it indicates that the Executive rejected the macro 
call because it resulted in an incorrect DPB. If the C bit is clear, 
format of the macro call is correct, but the I/O has not necessarily 
been successful. 


The directive status word can be tested to determine whether the 
Executive successfully queued the I/O request. It is tested following 
the WTSE$ macro call associated with the QIO$. If the request was not 
queued, the directive status word contains one of the error codes 
listed below. 


The I/O status block can be tested upon I/O completion to determine 
the success or failure of the actual transfer. The format of the I/0 
status block is illustrated below. I/O status error codes are 
provided in Appendix C. 


The first call of this macro defines the following symbols and 
assigns, as values, their byte offset from the beginning of the DPB. 


Q.IOFN = (length 2 bytes) I/O function 

Q.IOLU = (2) Logical unit number 

Q.IOEF = (1) Event flag number 

Q.IOPR = (1) Priority 

Q.IOSB = (2) Address of I/O status block 

Q.IOAE = (2) Address of I/O done AST entry. point 
Q.IOPL = (12) Parameter list (up to 6 words). 


DSW return codes: 


+1 -- Successful completion 
-01 -=- Unavailable pool node for request queue 


-05 <= Unassigned LUN 
-06 -- Handler task not resident 
“95 <-- Invalid Priority (>250) 


-96 -- Invalid LUN 
-97 == Invalid event flag number (<1 or >64) 
“98 <= Part of DPB is out of issuing task’s address space 
“99 o= DIC or DPB size is invalid 
Figure 3-1 illustrates the content of the I/O status block. 
Byte 1 Byte 0 


Word 0 TTY Termination Success Indicator 
Character 


OR 


CTRL Z (EOF) Indicator 


Word 1 Number of Characters Transmitted 


Figure 3-1 
I/O Status Block 


Word 0 can contain two l=-byte entries (TTY termination character and 
success indicator) or it can contain a -10 to indicate CTRL Z (EOF). 
If two entries are placed in word 0, the success indicator contains a 
l to indicate that the operation was successful or an error code, as 
described in Appendix C. 


The TTY termination character is used by teletype handler tasks and 
similar handler tasks (e.g., DECwriter) and can be one of the 
following: 


15(8) = CR, 
33(8) = ALT, 
0 = maximum number of characters received. 


Word 1 contains the number of characters transmitted to or from the 
I/O device. 


Macro Expansion: 


QI9$ TI.WVG, 3,359,380, L038, QIOAST, eBUF, SIZ, 4A» 
e3VTE 1, 3334RG 

eNIRNA 19,4VB8 

ol ORO 3 

»BYTE 3,539 

eNORY loss 

oe #RA QIJAST 


e4ORD = RUF 
49RD «SIZ 
WORD 4D 


aiows 


3.35 QIOW$ (QUEUE I/O AND WAIT) 


The QUEUE I/O AND WAIT directive performs the functions of both QUEUE 
I/O and WAIT FOR SINGLE EVENT FLAG (WTSE$). The format of the call 
and other related information is identical with that of QIOS$, with the 
following exception: if event flag 0 is specified, the queue I/O is 
performed, but the wait is not performed. 


The user should check the C bit and the I/O status block immediately 
after the macro call. 


Macro Call: QIOWS 
DSW return codes: 


All those returned for QIO 
-97 == Event flag >64 


Macro Expansions 


IT IW8 T9.2LA.5,3,29%, T95A1,RDAST, <INBUF,SIZE> 
eBYTE 3, 83 8ARG 

e AIRY TO.RL4A 

eW9RY 5 

envre 3,2aa 

eA TR TIS4t 

eWIRN ROAST 

etyey INSUF 

eNIRQD SIZE 


RDAF$ 


3.36 RDAF$ (READ ALL FLAGS) 


The READ ALL FLAGS directive reads all 64 event flags for the issuing 
task and records their polarities in a 64-bit (4-word) buffer, 


Macro Call: RDAFS bufadr 
bufadr = Address of 4-word buffer. 


The following symbol is locally defined with its assigned value equal 
to the byte offset from the start of the DPB to the DPB element. 


R.DABA = (Length 2 bytes) buffer address 


DSW return codes: 


+1 -=- Successful completion 
-98 -- Part of DPB or buffer is out of issuing task's 


address space 
~99 -=- DIC or DPB size is invalid 


Macro Expansion: 


RLAFS FLAGS 
eEYTE 396n2 
~+0a0 FLAGS 


RDEFS 


3.37 RDEF$ (READ EVENT FLAG) 


The READ EVENT FLAG directive tests an indicated event flag and 
reports its polarity in the DSW. 


Macro Call: RDEFS$ efn 
efn = Event flag number 


The following symbol is locally defined with its assigned value equal 
to the byte offset from the start of the DPB to the DPB element. 


R.DEEF = (Length 2 bytes) event flag number 
DSW return codes: 
+0 == Flag was cleared 
+2 == Flag was set 
-97 <= Event flag number <1 or >64 
-98 <-- Part of DPB is out of issuing task's address space 
-99 <= DIC or DPB size is invalid 


Macro Expansion: 


RCEFS & 
oRYTE 37.,? 
e BARN 5 


RQST$ 


3.38 RQSTS$ (REQUEST) 


The REQUEST directive activates a task, i.e., enables and runs the 
task contingent upon priority and memory availability. If the task 
cannot be run immediately, the request is retained so that the task 
executes when conditions change, i.e., when more memory is available. 
It cannot be issued by a background task. 


Macro call: RQST$ task,part,pri,ugc,upe 


task = Task name, 
part = Partition name, 

pri = Priority 

uge = UIC group code, 

upe = UIC programmer code, 


A partition cannot be specified for a multiuser task; i.e., the task 
must be requested to execute in its default partition. 


The following symbols are locally defined with their assigned values 
equal to the byte offset from the start of the DPB to the respective 
DPB elements. 


R.QSTN = (length 4 bytes) task name in radix 50 
ReQSPN = (4) Partition name 

R.QSPR = (2) Priority 

R.QSGC = (1) UIC group code 

ReQSPC = (1) UIC programmer code 


DSW return codes: 


+1 -- Successful completion 

-01 -- Insufficient pool nodes available to requester 
“02 -- Task not installed 

-03 -- Partition too small for task 

-06 -- Handler task not resident to load task 

-07 -- Task is active 

-08 -= Task is disabled 

“80 -=- Directive issued by background task 

-91 -=- Invalid UIC 

-94 == Partition not in system (no TPD entry found) 
-95 -- Invalid priority specified (<0 or >250) 

-98 -=- Part of DPB is out of issuing task's address space 
-99 -- DIC or DPB size is invalid 


Macro Expansion: 


RQSTS AYTAS“,GENRL,9,148,52 
eOYTE 11.,7 

eFANSD /MYTASK/ 

eRADSA /RENPLS 

2g? 5 

eEYTE 53,149 


RSUMS 


3.39 RSUM$ (RESUME) 


The RESUME directive instructs the system to resume the execution of a 
task that has issued a suspend directive. If the task being resumed 
is a multiuser task, it is resumed only if its TI matches that of the 
task issuing the RESUME directive. The RESUME directive cannot be 
issued by a background task, 


NOTE 


It is possible for a task to 
RESUME itself using’ the 
asynchronous trap feature. 


Macro Call: RSUMS task 
task = Task name, 


The following symbol is defined locally with its assigned value equal 
to the byte offset from the start of the DPB to the DPB element. 


RoSUTIN = (length 4 bytes) task name 
DSW return codes: 


+1 -=- Successful completion 

-02 -- Task not installed 

“07 <= Task not active 

-08 -= Task not suspended 

-80 -*=- Directive issued by background task 

-98 -- Part of DPB is out of issuing task's address space 
“99 <= DIC or DPB size is invalid 


Macro Expansion: 


ROUMS TASKS 
oF YTE 47,73 
eR ODSA STASKSs 


RUNS 


3.40 RUNS (RUN) 


The RUN directive causes a task to be requested at a specified future 
time, and optionally repeated periodically. The schedule time is 
specified in terms of delta time from issuance, The RUN directive 
cannot be issued by a background task. 


Macro Call: RUNS tsk,prt,pri,ugc,upc,smg,snt,rmg,rnt 


tsk = Task name, 
prt = Partition name, 
pri = Priority 
ugc = UIC group code 
upc = UIC programmer code, 
smg = Schedule delta magnitude i.e., how many schedule 
units, 
snt = Schedule delta unit, 
l= clock ticks 
2= seconds 
3= minutes 
4= hours 
rmg = Reschedule interval magnitude, 
rnt = Reschedule interval unit 


A partition cannot be specified for a multiuser task; i.e., the task 
must be requested to execute in its default partition. 


The following symbols are locally defined with their assigned values 
equal to the byte offset from the start of the DPB to the respective 
DPB elements. 


R.UNTN = (length 4 bytes) task name 
Re UNPN = (4) Partition name 

ReUNPR = (2) Priority 

R.UNGC = (1) UIC group 

ReUNPC = (1) UIC programmer 

R.UNSM = (2) Schedule magnitude 
ReUNSU = (2) Schedule unit 

R.UNRM = (2) Reschedule magnitude 
R.UNRU = (2) Reschedule unit 


DSW return codes: 


+1 -- Successful completion 

-01 -- Insufficient pool nodes available to requester 
-02 -- Task not installed 

-03 -- Partition too small for task 

-80 -= Directive issued by background task 

-91 -- Invalid UIC 

-93 -- Invalid time parameter specified 

-94 -- Partition not in system 

-95 -= Invalid priority specified (<0 or »250) 

-98 -— Part of DPB is out of issuing task’s address space 
“99 == DIC or DPB size is invalid 


Macro Expansion: 


RUNGE AOIT,MOSP4R,25,51,49,10,35,15,3 
oRYTE Ney Prey Bs Ie 

oFADSO SDODITS 

ePFANSA /MOQSPAKRS/ 

ewe as 


a VTE I7, 31 
ow IR) 1a 
ewe 3 
eX ORY 1S 
ena) 3 


SCHDS 


3.41 SCHD$ (SCHEDULE) 


The SCHEDULE directive causes a task to be requested at ai specified 
future time, and optionally, repeated periodically. The schedule time 
is specified in terms of absolute time-of-day. The SCHEDULE, RUN, and 
SYNC directives are the same, differing only in the form in which the 
schedule data is presented. SCHEDULE cannot be issued by a background 
task. 


Macro Call: SCHD$ tsk,prt,pri,ugc,upc,hrs ,min,sec,tck,rmag,rnt 


tsk = Task name, 
prt = Partition name, 
pri = Priority, 
ugc = UIC group code, 
upe = UIC programmer code, 
hrs = Schedule hours, 
min = Schedule minutes, 
sec = Schedule seconds, 
tck = Schedule clock ticks, 
rmag = Reschedule interval magnitude (how many of the units 
defined by rnt), 
rnt = Reschedule interval unit. 
1 = clock ticks 
2 = seconds 
3 = minutes 
4 = hours 


A partition cannot be specified for a multiuser task; i.e., the task 
must be requested to execute in its default partition. 


The following symbols are locally defined with their assigned values 
equal to the byte offset from the start of the DPB to the respective 
DPB elements. 


S.CHTN = (length 4 bytes) Task name 
S.CHPN = (4) Partition name 
S.CHPR = (2) Priority 

S.CHGC = (1) UIC group 

S.CHPC = (1) UIC programmer 
S.CHHR = (2) Hours 

S.CHMI = (2) Minutes 

S.CHSC = (2) Seconds 

S.CHCT = (2) Clock ticks 

S.CHRM = (2) Reschedule magnitude 
S.CHRU = (2) Reschedule unit 


DSW return codes: 


+1 -- Successful completion 

-01 -- Insufficient pool nodes available to requester 
-02 -= Task not installed 

-03 -- Partition too small for task 

-80 -- Directive issued by background task 

“91 <= Invalid UIC 

~93 -- Invalid time parameter specified 

-94 -- Partition not in system 

-95 -- Invalid priority specified (<0 or >250) 

-98 -- Part of DPB is out of issuing task's address space 
~-99 == DIC or DPB size is invalid 


Macro Expansion: 


SCHDS POIL CORE, 2939,40,40,1%,57,490,404,5,3 
aBYTE {S613 , 

eK495D SPOOLS 

eV ANSE SCORES 

e WIR) 22a 

aBYTE Gu,da 

ewaey 1a 


eKORD 32 
2WARD GA 
eviORA AA 
ew ORN 5 
e4IRA 3 


SETFS$ 


3.42 SETFS$ (SET EVENT FLAG) 
The SET EVENT FLAG directive sets an indicated event flag and reports 
the flag's polarity before setting in the DSW: Setting an event flag 
does not cause an ATL scan. 

Macro Call: SETF$ efn 

efn = event flag number 


The following symbol is locally defined with its assigned value equal 
to the byte offset from the start of the DPB to the DPB element. 


S.ETEF = (Length 2 bytes) event flag number 
DSW: 

+0 <= Flag was cleared 

+2 <-- Flag was set 

-97 <= Event flag number <1 or 564 


-98 -- Part of DPB is out of issuing task's address space 
-99 -=- DIC or DPB size is invalid 


NOTE 


It is recommended that the user avoid 
specifying event flag numbers from 59 to 
64, which are reserved for RSX-11D. 


Macro Expansion: 


SETFS 33 
eEYTE 33.,2 
o 40RD as 


SFPA$ 


3.43 SFPAS$ (SPECIFY FLOATING POINT EXCEPTION AST) 


The SPECIFY FLOATING POINT EXCEPTION AST directive instructs the 
system to record one of the following two items: 


1. That floating point exception ASTs for the issuing 
task are desired and where control is to be 
transferred when a floating point exception AST 
occurs, 


2. The floating point exception ASTs for the issuing 
task are no longer desired. 


When an AST service entry point is specified, future floating point 
exception ASTs occur for the issuing task, and control is transferred 
to the indicated location whenever a floating point exception AST 
occurs. 


When an AST service entry point is not specified (zero in the second 
DPB word), future floating point exception ASTs do not occur until an 
AST entry point is specified again. ASTs are described in Section 
4.2. 
If SFPAS is not used, no AST is queued, 
AST service routines must save and restore all registers used. 

Macro Call: SFPAS ast 


ast = AST service entry address. 


The following symbol is locally defined with its assigned value equal 
to the byte offset from the start of the DPB to the DPB element. 


S.FPAE = (Length 2 bytes) AST entry address 
DSW return codes: 


+1 -- Sucessful completion 

-01 -=- No pool node available 

-08 -- AST entry already un-specified 

-80 -- Directive issued during AST service 

-98 <-- Part of DPB is out of issuing task's address space 
-99 == DIC or DPB size is invalid 


NOTE 


This directive applies only for 
PDP-11/45. It has no effect on 
PDP-11/40. For the PDP-11/40, refer to 
SVTKS. 


Macro Expansion: 


SF2ag Fpasr 
avre 111.2. 
0 VIR FOAST 


SPND$ 


3.44 SPNDS$ (SUSPEND) 
The SUSPEND directive suspends the execution of the issuing task. A 
task can suspend only itself and not another task. The SUSPEND 
directive cannot be issued by a background task. 

Macro Call: SPND$ 

DSW return codes: 
+2 -- Successful completion 

“80 -- Directive issued by background task 

-98 <-- Part of DPB is out of issuing task's address space 

-99 -=- DIC or DPB size is invalid 


ifacro Expansions: 


SPNOS 
ebYTE QSeel 


SPRAS$ 


3.45 SPRA$ (SPECIFY POWER RECOVERY AST) 


The SPECIFY POWER RECOVERY AST directive instructs the system to 
record either of the following: 


1. That power recovery AST's for the issuing task are 
desired, and where control is to be transferred when 
a power recovery AST occurs, or 


2. That power recovery AST's for the issuing task are 
no longer desired. 


When an AST service routine entry point is specified, future power 
recovery ASTs occur for the issuing task, and control is transferred 
to the indicated location whenever a power recovery occurs. When an 
AST service entry point is not specified (zero in the second DPB 
word), future power recovery ASTs do not occur until an AST entry 
point is specified again. ASTs are described in Section 4.2. 


If SPRA$ is not used, no AST is queued. 
AST service routines must save and restore all registers used. 
Macro Calls SPRAS$ ast 


ast = AST service routine entry address or zeros if none is 
desired. 


The following symbol is locally defined with its assigned value equal 
to the offset from the start of the DPB to the DPB element. 


S.PRAE = (Length 2 bytes) AST entry address 
DSW return codes: 


+1 == Successful completion 

-01 <= #No pool node available 

~08 -- AST entry already unspecified 

-80 -- Directive issued during AST service 

“98 <-- Part of DPB is out of issuing task'’s address space 
-99 -- DIC or DPB size is invalid 


Macro Expansion: 


SPAS PWRAST 
o3YTE 149.,e 
oH AR PURAST 


SRDAS$ 


3.46 SRDA$ (SPECIFY RECEIVE AST) 


The SPECIFY RECEIVE AST directive allows a task to determine whether 
another task has sent data to it. When the sending of data is 
detected, the AST is executed. Use of this directive eliminates the 
need for the receiving task to check a buffer constantly for the 
presence of data. ASTs are described in Section 4.2. 


Macro Call: SRDAS ast 


ast = AST service entry point. If ast is specified, receive 
occurs for the issuing task and control is transferred 
to the entry point. If ast is not specified, ASTs do 
not occur. 


The following symbol is defined locally with its assigned value equal 
to the byte offset from the start of the DPB. 


S.RDAE = AST entry address (two bytes) 
DSW return codes: 


+1 -- Successful completion 

-01 -=- No pool node available 

-08 -- AST entry already unspecified 

-80 -- Directive issued during AST service 

-98 -- Part of DPB is out of issuing task's address space 
-99 -=- DIC or DPB size is invalid 


AST service routines must save and restore all registers used. 


Macro Expansion: 


SRDAS RCVAST 
eBYTE 127.42 
ow JRO acvas}?l 


SVDBS 


3.47 SVDB$ (SPECIFY SST VECTOR TABLE FOR DEBUGGING AID) 


The SPECIFY SST VECTOR TABLE FOR DEBUGGING AID directive specifies the 
virtual address of a table of synchronous system trap service routine 
entry points for use by an intratask debugging aid (e.g., ODT). SSTs 
are described in Section 4,2. 


When both the issuing task table and the ODT exist and both contain an 
entry for a particular trap, the ODT table takes precedence. 


The table can contain up to eight entry points. Each entry point 
corresponds to a type of error that could occur or an instruction. 
The table is in the following format. 


WD. 00 -=- Odd address error or other trap through 4 
WD. O1 -- Segment fault 

WD. 02 -= T=bit trap or execution of a BPT instruction 
WD. 03 -=- Execution of an ‘IOT' instruction 

WD. 04 -- Execution of a reserved instruction 

WD. O05 -=- Execution of non-RSX EMT. 

WD. 06 == Execution of a trap instruction, 

WD. O07 <= PDP-11/40 floating point exception 


If the table does not exist and one of the errors or instructions 
listed in the table above occurs, the task is aborted. Likewise, the 
task is aborted if the table exists but does not contain an entry 
point that corresponds to a particular error or instruction and that 
error or instruction occurs. 


The table does not exist if SVDB$ was not specified or if the macro 
call contained incorrect parameters. 


SST service routines must save and restore all registers used. 
Macro Call: SVDB$ adr,len 


adr = Address of SST vector table 
len = Number of entries in table 


The following symbols are locally defined with their assigned values 
equal to the byte offset from the start of the DPB to the respective 
DPB elements. 


S.VDTA = (Length 2 bytes) table address 
S.VDTL = (2) Table length 


DSW return codes: 
+01 <= Successful completion 
-98 -- Part of DPB or table is out of task's address 
space, or table address not specified (zero 
address) 
-99 <= DIC or DPB size is invalid 


Macro Expansions 


Sv )d8 SSFTIL,a 


eAYTE = 135443 
eVORD SS TTBL 
2992904 


SVTKS$ 


3.48 SVTK$ (SPECIFY SST VECTOR TABLE FOR TASK) 


The SPECIFY SST VECTOR TABLE FOR TASK directive specifies the virtual 
address of a table of synchronous system trap service routine entry 
points for use by the issuing task. When both the issuing task table 
and the ODT table exist and both contain an entry for a particular 
trap, the ODT table takes precedence. SSTs are described in Section 
4.2. 


The table can contain up to eight entry points. Each entry point 
corresponds to a type of error that could occur or an instruction. 
The table is in the following format. 


WD.00 -=- Odd address error, 

WD.01 -- Segment fault 

WD.02 -=- T=-Bit trap or execution of a BPT instruction 
WD.03 -= Execution of an IOT instruction 

WD.04 -= Execution of a reserved instruction 

WD.05 == Execution of non-RSX EMT, 

WD.06 -=— Execution of a trap instruction 

WD.07 ~-=- PDP-11/40 floating point exception. 


If the table does not exist and one of the errors or instructions 
listed in the table above occurs, the task is aborted. Likewise, the 
task is aborted if the table exists but does not contain an entry 
point that corresponds to a particular error or instruction and that 
error or instruction occurs. 


The table does not exist if SVTKS$ was not specified or if the macro 
call contained incorrect parameters. 


SST service routines must save and restore all registers used. 
Macro Call: SVTK$ adr,len 


adr = Address of SST vector table 
len = Length of (number of entries in) table 


The following symbols are locally defined with their assigned values 
equal to the byte offset from the start of the DPB to the respective 
DPB elements. 


S.VITA = (Length 2 bytes) table address 
S.VTTL = (2) Table length 


DSW return codes: 


+1 -=- Successful completion 
-98 <= Part of DPB or table is out of task's address 
space, or table address is not specified (zero 
address) 
-99 <= DIC or DPB size is invalid 


Macro Expansion: 


SVTKS SSff4al.e2 
eSYTE 145.,3 

2 WR) S57TTS3t 
o89R4 a 


SYNCS 


3.49 SYNCS (SYNCHRONIZE) 


The SYNCHRONIZE directive requests a task at a specified future time, 
and optionally, repeats it periodically. The schedule time is 
specified in terms of delta time from clock unit synchronization. 
Clock unit synchronization is specified for a future time, 
SYNCHRONIZE differs from RUN in that RUN requests task execution for 
delta time from the present time, not delta time from a future time. 
The SYNCHRONIZE directive cannot be issued by a background task. 


Macro Call: SYNC$ tsk,prt,pri,ugc,upc,smg,snt,sync,rmg,rnt 


tsk = Task name, 
prt = Partition name, 
pri = Priority, 
ugc = UIC group code, 
upe = UIC programmer code, 
smg = Schedule delta magnitude; i.e., how many delta units 
snt = Schedule delta unit, 
1 = clock ticks 
2 = seconds 
3 = minutes 
4 = hours 
syne = Synchronization unit, 
rmg = Schedule interval magnitude, 
rnt = Schedule interval unit. 


A partition cannot be specified for a multiuser task; i.e., the task 
must be requested to execute in its default partition. 


The following symbols are locally defined with their assigned values 
equal to the byte offset from the start of the DPB to the respective 
DPB elements. 


S.YNTN = (length 4 bytes) task name 
S.YNPN = (4) Partition name 

S.YNPR = (2) Priority 

S.YNGC = (1) UIC group code 

S.YNPC = (1) UIC programmer code 
S.YNSM = (2) Schedule magnitude 
S.YNSU = (2) Schedule unit 

S.YNSY = (2) Synchronization 
S.YNRM = (2) Reschedule magnitude 
S.YNRU = (2) Reschedule unit 


DSW return codes: 


+1 -- Successful completion 
“01 -- Insufficient pool nodes available to requester 
-02 <-- Task not installed 
-03 <- Partition too small for task 
“80 <-=- Directive issued by background task 
-91 -- Invalid UIC 
-93 <-- Invalid time parameter specified 
“94 <-- Partition not in system 
“95 <= Invalid priority specified (<0 or >250) 
-98 -- Part of DPB is out of issuing task's address space 
“99 == DIC OR DPB size is invalid 


Macro Expansion: 


SYNCS THIS, GENRL,55,148,190,6,2,3,10.,0 
eH VTE 19,,12, 

aRADSS STHIS/ 

eRANSO 3 /GENRLS 


awORD ss 
enYTe 1963,1%9 
eM IRA 6 
eWwOR) 2 
ow IRD 3 
oH ORD 14 
eX ORD e 


UFIXS 


3.50 UFIX$ (UNFIX) 


The UNFIX directive negates a FIX directive that has been issued to 
make a task permanently memory~-resident. The task specified in the 
UNFIX directive must have the same TI as the issuing task. The task 
then can be removed from memory. UNFIX cannot be issued by a 
background task. 


Macro Calls: UFIXS task 
task = Task name, 


The following symbol is locally defined with its assigned value equal 
to the byte offset from the start of the DPB to the DPB element. 


U.FXTN = (length 4 bytes) task name 
DSW return codes: 


+1 -- Successful completion 
-02 -- Task not installed 
-09 -- Task is already unfixed 
“80 -=- Directive issued by background task 
“98 <-=- Part of DPB is out of issuing task's address space 
“99 =-- DIC or DPB size is invalid 


Macro Expansion: 


UFTXS POL 
wPYTE «F748 
e8805% /POSLZ 


VRCD$ 


3.51 VRCD$ (RECEIVE DATA) 


The RECEIVE DATA directive receives a variable-length data block that 
has been queued for it according to priority. The SEND DATA or SEND 
DATA AND RESUME OR REQUEST RECEIVER directives queue data for a 
receiver. 


When a sender task is specified, only data sent by the indicated task 
is received, 


If the buffer size is not specified, a default size of 13 words is 
used. A 2=-word sending task name and the data block are placed in the 
indicated buffer. The task name is in the first two words. The 
buffer length should not include these two words. 


If the location to store the TI is specified, the TI indicator is 
transferred from the SEND/RECEIVE node to this location, 


If the receiver task is multiuser, only data with the same TI 
assignment is received. 


Data is transferred from the sending task to the receiving task by 
means of nodes picked from the pool. The number of nodes picked is 
charged to the sender. When the data is received, the nodes are 
returned and subtracted from sender's usage count, 


Macro calls VRCDS task,bufadr,buflen,ti 


task = sender task name 
bufadr = buffer address 
buflen = buffer length 

ti = address to store TI 


The following symbols are locally defined with their assigned values 
equal to the byte offset from the start of the DPB to the respective 
DPB elements. 


R.VDIN = (length 4 bytes) task name 
R.VDBA = (2) buffer address 

R.VDBL = (2) buffer length 

R.VDTI = (2) address in which to store TI 


Condition codes: 


CC-C = cleared to indicate successful completion. 
cC-C = set (with CC-V unaltered) if rejection occurs. 
cC-vV - set if sender task is privileged 


DSW return codes: 


+01 <= 
-02 — 
-08 —-—- 
“15 «= 
-89 «= 
-9$ w= 
-99 


An alternate macro 


successful completion 

sender task not installed 

no data queued (sent) 

receiver's buffer too small, data truncated 

invalid buffer size (>255) 

part of DPB or buffer is out of task's address 
space 

DIC or DPB size is invalid. 


call is RCVDS which receives a 13-word data block. 


Macro call: RCVD$ task,bufadr 


Macro Expansion of 


VANS 
eS¥TE 
eRANSGA 
o4wgRD 
allF GE 
tte &49 


VRCD$§ 


OTHER, DATAIN, 25.,TIANDR 
T5 ee 58879 

AITHER/ 

NATAIN 

$857905, WORN 25, 
5ST ewan, WORN TIANDR 


VRCS$ 


3.52 VRCS$ (RECEIVE DATA OR SUSPEND) 


The RECEIVE DATA OR SUSPEND directive receives a variable-length data 
block that has been queued according to priority for it or suspends if 
no data blocks can be received. The SEND DATA and SEND DATA AND 
RESUME OR REQUEST RECEIVER are used to queue data for a receiver. 
This directive cannot be issued by background task. 


When a sender task is specified, only data sent by the indicated task 
is received. 


If the buffer size is not specified, a default size of 13 words is 
used. A 2-word sending task name and the data block are returned in 
the indicated buffer. The task name is in the first two words. The 
buffer length should not include these two words. 


If the location at which to store TI is specified, the TI indicator is 
transferred from the SEND/RECEIVE node to this specified location. 


If the receiving task is multiuser, only data with the same TI 
assignment is received. 


Data is transferred from the sending task to the receiving task by 
means of nodes picked from the pool. The number of nodes picked is 
charged to the sender. When the data is received, the nodes are 
returned and subtracted from sender's usage count. 


Macro call: VRCS$ task,bufadr,buflen,ti 


task = sender task name 

bufadr = buffer address 

buflen = buffer length 

ti = address in which to store TI 


The following symbols are defined locally with their assigned values 
equal to the byte offset from the start of the DPB to the respective 
DPB elements. 


R.VSTN = (length 4 bytes) task name 
R.VSBA = (2) buffer address 

= (2) buffer length 

R.VSTI = (2) address in which to store TI 


Condition codes: 


CC-C -~ cleared to indicate successful completion. 
CC-C =- set (with CC-V unaltered) if rejection occurs. 
CC-vV - set if sender task is privileged 


DSW return codes; 


+01  -=- successful completion 

-02 ~- sender task not installed 

#15 -- receiver's buffer too small, data truncated 

-80 -- directive issued by background task 

-89 -- invalid buffer size (>255). 

-98 -- part of DPB or buffer is out of task's address 
space 

~99 -- DIC or DPB size is invalid. 


An alternate macro call is RCVSS which receives a 13-word data block. 
Macro call: RCVS$ task,bufadr 


Macro Expansion of VRCSS$: 


WROSS TASHA, HWATAIN, (4,,TTANOR 
w3YTE 79,,8S53T9 

~RANSQ /TAS#DS/ 

Swe yaTaty 

wT F FE RVETIOS, WORN 1A. 
elTF FV 358T905,,0NIN TLADNR 
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3.53  VRCX$ (RECEIVE DATA OR EXIT) 


The RECEIVE DATA OR EXIT directive receives a variable-length data 
block that has been queued for it according to priority or exits if no 
data block can be received. The SEND DATA and SEND DATA AND RESUME OR 
REQUEST RECEIVER directives queue data for a receiver. 


When a sender is specified, only data sent by the indicated task is 
received. 


If the buffer size is not specified, a default size of 13 words is 
used. A 2-word sending task name and the data block are returned in 
the indicated buffer. The task name is in the first two words. The 
buffer length should not include these two words. 


If the location to store TI is specified, the TI indicator is 
transferred from the SEND/RECEIVE node to this specified location. 


If the receiving task is multiuser, only data with the same TI 
assignment is received. 


Data is transferred from the sending task to the receiving task by 
Means of nodes picked from the pool. The number of nodes picked is 
charged to the sender. When the data is received, the nodes are 
returned and subtracted from sender's usage count. 


Macro call: VRCXS task,bufadr,buflen,ti 


task = gender task name 

bufadr = buffer address 

buflen = buffer length 

ti = address at which to store TI 


The following symbols are locally defined with their assigned values 
equal to the byte offset from the start of the DPB to the respective 
DPB elements. 


R.VXTN = (length 4 bytes) task name 
R.VXBA = (2) buffer address 
R.VXBL = (2) buffer length 

R.VXTI = (2) address in which to store TI 


Condition codes: 


CC-C = cleared to indicate successful completion. 
CC-V = set (with CC-V unaltered) if rejection occurs. 
CC-C =- set if sender task is privileged 


DSW return codes: 


+01 -~- successful completion 

-02 “- sender task not installed 

“15 -- receiver's buffer too small, data truncated 

~-89 -- invalid buffer size (>255) 

~98 “-- part of DPB or buffer is out of task's address 
space 

-99 -- DIC or DPB size is invalid. 


An alternate macro call is RCVX$ which receives a 13-word data block. 


Macro call: RCVX$ task,bufadr 


Macro Expansion of VRCXS: 


JIROXS TASK9, HUFIN, 8, »TLANDR 
aAuYTE 77.,558T9 

aRAD5H /STASKIS 

WORD UF It 

ett GE $4ST905, WORD 3, 
alTF FEN S33T9enm, WORD TIAODR 


VSDAS$ 


3.54 VSDA$ (SEND DATA) 


The SEND DATA directive queues a variable-length data block according 
to priority for a task to receive. 


If the buffer size is not specified, a default of 13 words is used. 


When an event flag is specified, a significant event is declared if 
the directive is performed; the indicated event flag is set. 
Normally, the event flag is used to trigger the receiver into some 
action. The user must distinguish between the task's event flags (1 
through 32) and the systems's event flags (33 through 64). To be 
effective, the task must set a system event flag. 


If no priority is specified, the priority of the sending task is used, 


If a TI is specified for the receiving task, the specified TI is 
inserted in the SEND/RECEIVE node; an AST is declared if an active 
task with the same TI is found. If no TI is specified, the sender's 
TI is inserted in the SEND/RECEIVE node; an AST is declared if the 
task is active regardless of its TI. 


Data is transferred from the sending task to the receiving task by 
means of nodes picked from the pool. The number of nodes picked is 
charged to the sender. ‘When the data is received, the nodes are 
returned and subtracted from sender's usage count. 


Macro Call: VSDAS task,bufadr,buflen,efn,sndpri,ti 


task = receiver task name 

bufadr = address of data block 

buflen = length of buffer (1 through 255 words) 

efn = event flag number (0 implies no event flag) 
sndpri = priority of send (1 through 250) 

ti = TI indicator 


The following symbols are defined locally with their assigned values 
equal to the byte offset from the start of the DPB to the respective 
DPB elements. 


(length 4 bytes) task name 


S.DATN = 

S.DABA = (2) buffer address 
S.DAEF = (2) event flag number 
S.DABL = (2) buffer length 
S.DASP = (2) send priority 
S.DATI = (2) TI indicator 


DSW return c 


+01 -- 
~02 «= 
-04 -- 
-88 << 
-89 -< 
-97 -- 


odes: 


successful completion 

receiver task not installed 

insufficient pool nodes for SEND 

invalid TI 

invalid buffer size (size > 255) 

invalid event flag number (event flag number < 0 or > 
64) 

part of DPB or data block is out of task'’s address 
space 

DIC or DPB size is invalid 


An alternate macro call is SDATS$ which sends a 13-word data block. 


Macro call: SDATS$ task,bufadr,efn 


Macro Expansion 


VSIAS 
e SYTE 
2 2 NSP 
oI) 


of VSDAS: 


TA3564,0ATA, 23, $6,244, TI ADDR 
Flee 83579 
/TAS<S/ 
JATA 
34 

1F RSSTIOS, eVORD 24 

F SE S38T9e7, eWORND ea 
Q paslao8,, 2 10ROD TIADDOR 


VSDR$ 


3.55 VSDR$ (SEND DATA AND RESUME OR REQUEST RECEIVER) 


The SEND DATA AND RESUME OR REQUEST RECEIVER queues a variable-length 
data block according to priority for a task to receive and to requert 
or resume the execution of the receiver. This directive cannot iv: 
issued by a background task, 


This directive has the effect of issuing a SEND DATA directive 
followed by a REQUEST directive with the following exceptions: 


l. No task switching occurs between the SEND and the RECEIVE or 
RESUME, 


2. If the SEND is not performed, neither the RESUME nor the 
REQUEST is attempted. 


If the buffer size is not specified, a default buffer size of 13 words 
is used. 


When an event flag is specified, a significant event is declared if 
the directive is performed; the indicated event flag is set. The 
event flag is used commonly to trigger the receiver into some action. 
The user must distinguish between task event flags (1 through 32) and 
system event flags (33 through 64). 


To be effective, the task must set a system event flag. If the send 
priority is not specified, the priority of the sender is used to 
insert the SEND/RECEIVE node into the receiver's queue. 


If a TI is specified for the receiving task, the specified TI is 
inserted in the SEND/RECEIVE node. An AST is declared if an active 
task is found with the same TI and the task has specified RECEIVE AST. 
If no TI is specified, the TI of the sending task is inserted in the 
SEND/RECEIVE node; an AST is declared if the task is active 
regardless of its TI. 


Data is transferred from the sending task to the receiving task by 
Means of nodes picked from the pool. The number of nodes picked is 
charged to the sender. When the data is received, the nodes are 
returned and subtracted from sender's usage count. 


Macro call: VSDR$ task,part,pri,ugc,upc,bufadr,buflen,efn,sndpri,ti 


task = receiver task name 

part = partition 

pri = priority 

uge =z UIC group code 

upc = UIC programmer code 

bufadr = address of data block 

buflen = length of data block in words 

efn = event flag number (0 implies no event flag) 
sndpri = priority of send 

ti = TI indicator 


The following symbols are locally defined with their assigned values 
equal to the byte offset for the start of the DPB to the respective 
DPB elements. 


S.DRTN = (length 4 bytes) task name) 
S.DRPN = (4) partition name 

S.DRPR = (2) request priority 
S.DRGC = (1) UIC group 

S.DRPC = (1) UIC programmer 

S.DRBA = (2) buffer address 

S.DREF = (2) event flag 

S.DRBL = (2) buffer length 

S.DRSP = (2) send priority 

S.DRTI = (2) TI indicator 


DSW return codes: 


In the following code descriptions, R indicates that the 
REQUEST or RESUME was rejected, and B indicates that both the 
SEND and REQUEST or RESUME were rejected. 


+01 - data sent and task requested 

+02 ~ data sent and task resumed 

+03 - data sent to a non-suspended task 

-01 - [R] insufficient pool nodes available for REQUEST 
-~02 - [B] receiver task not installed 

-03 - [R]) partition too small for receiver task 

-04 - [B] insufficient pool nodes for SEND 

-06 - [R] handler task not resident to load task 

-08 - [R}) receiver task is disabled 

-80 - [{B] directive issued by background task 

-88 - [B]) invalid TI indicator 

-89 - [B) invalid buffer size (>255) 

-91 = (R) invalid uic 

-94 - [R] partition not in system 

-95 = [R] invalid priority specified (<0 or >250) 

-97 - [B] invalid event flag number (efn<0 or 64) 

-98 ~ (B) part of DPB or data block is out of the task’s 


address space 
-99 = [B] DIC or DPB size is invalid. 


NOTE 


The SEND portion of this directive can 
complete and the REQUEST portion fail. 


An alternate macro call is SDRQ$ which sends a 13-word data block. 


Macro call: SDRQ$ task,part,pri,ugc,upc,bufadr,efn 
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Macro Expansion of VSDRS: 


J$)28 YAS, PART, AA, ALA, AAA MYDATA, 3%, 60,34, TIAQDR 
.aYTe 73.,3585T9 

eVANSY SYD 

wIIF LT 8387104, e FWRI) a 

eRADISO /PARTS 

ere) 2a) ga 

eRYTE A114, ANY 

2H IRA MY)ATA 


24787 a4 

ITF 5F BSSTIOLIL, INA 30 
Ite Ge SSST9—14.,.NURD 34 
.Utr e) SSSTIMLA., WORD PFIADUR 
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WSIG$ 


3.56 WSIG$ (WAIT FOR SIGNIFICANT EVENT) 
The WAIT FOR SIGNIFICANT EVENT directive suspends execution of the 


issuing task until the next significant event occurs. It is an 
especially effective way to suspend a task which cannot continue 


because of a lack of pool nodes, 


Macro Call: WSIGS$ 


DSW return codes: 


+1 -=- Successful completion 


Macro Expansion: 


EYTE 49eel 


WTLOS 


3.57 WTLO$ (WAIT FOR LOGICAL OR OF FLAGS) 


The WAIT FOR LOGICAL OR OF FLAGS directive suspends the execution of 
the issuing task until any indicated event flag of one of the 
following groups of event flags is set. 


GRO -= FLAGS 1-16 
GR1l -=- FLAGS 17-32 
GR 2 == FLAGS 33-48 
GR 3 -- FLAGS 49-64 
GR 4 == FLAGS 1-64 


If the indicated condition is met at issuance, task execution is 
effectively not suspended, 


Mask word bits from right-to-left represent increasing event flag 
numbers. A set mask word bit indicates that the task is to wait for 
the corresponding event flag. 

Macro Call: WTLOS set,mask 


set = Desired set of event flags 


mask = If set is 0,1,2,3, mask is a l6 bit (16-flag) mask 
word; 


If set is 4, mask provides a list of four mask words 
in the form: < Ml, M2, M3, M4>. 


If zero is specified in the $S form of the macro, do 
not use a number sign (#) preceding it. 


Example: The following macro is used to wait for flag 19, or flag 20, 
or flag 21, or flag 32. 


WTLOS 1,100034 
Example: This macro waits for 1, 19, 20, 21, 32 or 64. 
WTLOS 4,<000001,100034,0,100000> 
DSW return codes: 
+1 -=- Successful completion 
“97 -- No event flag specified in mask word(s) 
or; Flag set indicator other than 0,1,2,3, or 4 
-98 == Part of DPB is out of issuing task's address space 
“99 =~ DIC or DPB size is invalid 


Macro Expansion: 


wTLOt 4,<41,5A%,2,343> 
eFYTE 43,,5 


eKORN 
awa = 4592 
woPD 2 
Sel De | 


WTSES 


3.58 WTSE$ (WAIT FOR SINGLE EVENT FLAG) 
The WAIT FOR SINGLE EVENT FLAG directive suspends the execution of the 
issuing task until an indicated event flag is set. If the flag is set 
at issuance, task execution is effectively not suspended. 

Macro Call: WTSES efn 

efn = event flag number 


The following symbol is locally defined with its assigned value equal 
to the byte offset from the start of the DPB to the DPB element. 


W.TSEF = (Length 2 bytes) event flag number 
DSW return codes 
+] == Successful completion 
-97 <= Invalid event flag number (<1 or »>64) 
“98 = Part of DPB is out of issuing task's address space 
“99 <= DIC or DPB size is invalid 


Macro Expansion: 


wISES 13. 
Pe a 41.,2 
oe # TRG 19, 
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CHAPTER 4 


SIGNIFICANT EVENTS AND SYSTEM TRAPS 


Understanding of trap logic and EMT handling as described in the 
PDP-1l1 Processor Handbook is a prerequisite to understanding this 
chapter. 


Significant events and system traps are the means by which 
communication is effected among various parts of the system. Events 
and traps appear to overlap in some areas, but three points may help 
to clarify their function and use. 


l. A significant event causes a change in system status; it 
causes the Executive to re-evaluate the eligibility for 
execution of all tasks. 


2. System Traps are exclusive to a single task; they are useful 
for intra-task communication and control, 


3. The occurrence of an event can only change the eligibility of 
a task to run. A trap, however, is a real interrupt; the 
sequence of instructions being executed by the task is 
interrupted and control is transferred to another place in 
the program. This process may be invisible to the user in 
some cases. However, it is a difference between events and 
traps e 


4.1 SIGNIFICANT EVENTS 


Significant events provide a mechanism for achieving dynamic. control 
of task execution. Tasks are able to declare and recognize 
Significant events through event-associated directives. The 
declaration and occurrence of significant events provide dynamic 
control over the execution of tasks. Waiting for an event, such as 
the waiting for an I/O request, can suspend a high priority program 
until that event occurs. Meanwhile, lower priority programs are 
allowed to run. 


Event flags.are the means by which RSX-11D and tasks distinguish one 
event from another. Associated with each task are 64 event flags. 
The first 32 flags (1-32) are unique to each task, and are set or 
cleared only as a result of that task's operation. The integrity of 
these flags is maintained by the task. They are stored in the task's 
ATL and are not available to other tasks. 


The second 32 flags (33-64) are common to all tasks, and can be set or 
cleared as a result of any task's operation. Therefore, they require 
system management to preserve their significance and are stored in 
SCOM,. 


Event flags usually are set when significant events occur, and tasks 
can read and/or clear them using system directives. Also, task 
execution can be suspended until a particular event flag or a_ logical 
combination of event flags is set. 


Some system processes running for the user need event flags. The last 
eight local (25-32) and global (57-64) event flags are reserved by 
convention for use by RSX-11D. Accounting uses flags 61 and 62. 


In addition, device handler tasks use event flag 1 for express 
requests and event flag 2 for normal requests. 


All significant events occur as the result of a task's having issued a 
system directive; some directives have the event explicitly noted, 
while in others it is implicit. Refer to Chapter 3 for a _ complete 
discussion of the directives. 


1. The DECLARE SIGNIFICANT EVENT directive allows any task to 
stimulate the event-driven system whenever necessary; 


2. The SEND, SEND AND RESUME OR REQUEST, or RESUME directives 
also cause a significant event at issuance; 


3. The directives that cause task execution (REQUEST, EXECUTE, 
SCHEDULE, RUN, and SYNCHRONIZE) also cause a significant 
event whenever task execution is initiated; 


4. The MARK TIME directive causes a significant event at a 
specified time interval after issuance; 


5. Most I/O operations (initiated by the QUEUE 1/0 directive) 
cause a significant event upon completion. Successful 
completion of the QUEUE I/O directive itself causes a 
significant event. 


The following examples show the usage of the common event flags for 
task synchronization. 


Example 1 -- Global Flags 


Task B specifies a global event flag (e.g., event flag number 35) ina 
WAITFOR directive, and task A specifies the same event flag in a SET 
EVENT FLAG directive at the time it is appropriate for task B_ to 
proceed. 


Example 2 -= Global Flags 


Task A specifies task B and a global event flag in a SEND directive. 
Task B has specified the same common event flag in a WAITFOR directive 
and issues a RECEIVE directive (to dequeue a block of data sent by 
task A) when activated because the WAITFOR is satisfied. 


Following are examples of event flag usage to detect I/O completion, 
and to indicate that a specified period of time has elapsed. 


Example 3 == Local Flags 


If an event flag is specified in QUEUE I/0 and associated WAITFOR 
directives, the flag is cleared when the request is queved. When the 
task executes a WAITFOR predicated on the same event flag and the 
requested action is not yet completed, execution of the task is 
suspended. 


The task performing the requested service sets the specified event 
flag when the request is completed, and the task's execution is 
resumed, 


Example 4 -- Local Flags 


If an event flag is specified in MARK TIME and WAITFOR directives, the 
flag is cleared at MARK TIME issuance and set after the indicated time 
has elapsed, and the task'’s execution is suspended for the indicated 
interval of time. 


In the above examples, computation and/or event flag testing are not 
precluded prior to, or instead of, the WAITFOR directive, i.e., 
specifying an event flag does not imply that a WAITFOR directive must 
be used. Event flag testing can be performed at any time. The 
purpose of a WAITFOR directive is to stop execution until an indicated 
significant event occurs. It is not necessary to issue a WAITFOR 
directive immediately following the issuance of a QUEUE I/O or a MARK 
TIME directive. 


4.2 SYSTEM TRAPS 


System traps are task interrupts initiated by the Executive to allow 
servicing of certain conditions or situations that can occur, 


When a task plans to use the system trap facility, it must contain a 
trap service routine. This routine is automatically entered when the 
trap occurs with the task's normal priority and privilege. The action 
taken by the Executive if a service routine is not supplied is 
dependent upon the type of trap and is described below. 


There are two types of system traps: synchronous system traps (SST's) 
and asynchronous system traps (AST's). 


SST's provide a means of servicing fault conditions within a task, 
such aS memory protection violation and PDP-11/40 floating point 
exceptions, These conditions, which are internal to a task and are 
not significant events, occur synchronously with respect to task 
execution. In these cases, if an SST service routine is not included 
in the task, the task's execution is aborted. 


AST's commonly occur as the result of a significant event and thus 
occur asynchronously with respect to a task's execution, i.e., a task 
does not have direct or complete control over when AST's occur. A 
characteristic of AST's is that they are for information purposes, 
such as signifying an I/O completion that a task wants to know about 
immediately and PDP-11/45 floating point exceptions. If an AST 
service routine is not provided, a trap does not occur and task 
execution is not interrupted. 


It should be emphasized that SST's only are initiated by the 
Executive; no further action is taken. That is, they appear to the 
Executive just like normal task execution. The Executive having 
initiated an SST, cannot determine that the task is in the SST service 
routine. Thus, an SST service routine can be interrupted by another 
SST or an AST. SST's can be nested. 


SST's are caused by activities internal to the task, while AST's occur 
as a result of an external event. The Executive keeps track of all 
AST's, queues them (FIFO) and is aware of when a task is executing an 
AST. 


4.2.1 Synchronous System Traps 


Before reading this section, it is advisable to review the vector 
interrupt logic as described in the PDP-1l Processor Handbook. 


When an SST occurs, the task's PSW (program status word) and PC 
(program location counter) are pushed onto its stack, and return from 
the SST routine is accomplished by issuing an RTI or RIT instruction. 


Execution of an SST service routine is indistinguishable from task 
execution, and an SST service routine can perform any operation that 
the task can. However, if a service routine for a system trap is to 
cause that same system trap to occur, it must be reentrant. 


SST service routine entry points are provided in a trap vector table 
which is contained in the task. The trap vector table is described in 
Section 3,41. 


A zero address in the vector table is interpreted as if no entry point 
were specified. If an SST occurs and no entry point is specified, the 
task's execution is aborted. If an invalid address is specified as an 
SST service address, an attempt is made to transfer control to the 
address specified, which probably results in an odd-address or segment 
fault. The SST vector table is given to the monitor by the task by 
use of the DECLARE SST VECTOR TABLE Directive. 


On entry to an SST service routine, the stack contains the following 
standard PDP-11 trap vector information: 


SP+02 PS 
SP+00 PC 


At the start of SST service, the stack can contain additional 
information depending on the cause of the trap, as follows. 


l. Segment Fault - 
Segmentation Status Register 1 
Segmentation Status Register 2 
Segmentation Status Register 0 
2. EMT Other Than 377 - 
Instruction Operand (low-order byte) times two 
Items 1 and 2, above, must be removed from the stack before the SST 
exit is taken. Exit from SST's is by means of an RTI or RIT 
instruction. 
The RTI or RTT instruction removes PC and PS from the stack. 
The additional data is pushed on the stack by the RSX-11D interrupt 
service routines. Seven trap service routines are provided as part of 


the RSX-11D Executive. Table 3-2 lists the ISRs and describes their 
functions. 


Table 4-1 
Executive Trap Service Routines 


Traps at location 114. If a parity 
error occurs at other than processor 
priority zero (Executive code), the 
system is crashed. If a parity error 
occurs at processor priority zero, the 
task's status is changed to task parity 
error and the task is effectively locked 
in memory and can execute no move. 


Memory Parity Interrupt 


Traps at location 4. If the cause of 
the trap is a red or yellow trap 
violation, the system crashes.If the 
trap was in task code and the SST vector 
table is defined, the SST service 
routine executes. If the SST vector 
table is not defined, the task is 
aborted. For other traps refer to 
Section 4.2.3. 


Odd Address and 
Miscellaneous Error 


Traps at location 250. If the segment 
fault occurs at other than task level, 
the system is crashed. If the segment 
fault was caused by task-level code, the 
user task is notified by means of an SST 
or aborted. 


Segment Faults 


Traps at locations 30 and 34. If the 
instruction is an EMT 377, control is 
transferred to the RSX-11D EMT handler. 
If the instruction was a.trap and the 
previous mode was kernel, control is 
transferred to the directive status 
return routine in the Executive. For 
other EMTs or traps, the user task is 
notified by an SST or is aborted. 


T Bit and BPT Traps at location 14. 


IOT and Reserved Traps at locations 20 and 10. 
Instruction 


EMTs and Traps 


Floating Point Traps at location 244. SST for 11/40 


Exception and AST for 11/45. 


4.2.2 Asynchronous System Traps 


When an AST occurs, the task's PSW and PC are pushed onto its. stack. 
There also can be other parameters pushed onto the stack depending 
upon the cause of the AST. 


After processing an AST, the trap dependent parameters must be removed 
from the task's stack, and an EXIT AST SERVICE directive is issued 
with the task's stack set as indicated in the description of the AST 
SERVICE EXIT directive. 


Upon AST service exit, control is returned to one of three places: 
1. Another (queued) AST; 
2. The task; 


3. Another task (e.g., the corresponding task was not in 
execution). 


Five variations on the stack format, depending upon the AST origin, 
are as follows: 


l. If a task is to be notified of power failure recoveries, a 
SPECIFY POWER RECOVERY AST directive is issued. 


SP+04 =-- PS of task at AST (interrupt), 
SP+02 == PC of task at AST (interrupt), 
SP+00 == Task's directive status (virtual zero). 


It is not necessary to pop any of this from the stack. 


2. When an I/O request is queued, an AST service entry point may 
be specified in the macro. If specified, an AST occurs upon 
cgmpletion of the request with the task's stack containing 
the following information: 


SP+16 -- Event flag mask word for flags 1-16 

SP+14 -- Event flag mask word for flags 17-32 

SP+12 -- Event flag mask word for flags 33-48 

SP+10 -= Event flag mask word for flags 49-64 

SP+06 -- PS of task at AST (interrupt), 

SP+04 -= PC of task at AST (interrupt), 

SP+02 -- Task's directive status (virtual zero), 

SP+00 == Address of I/O status block for request (or 
zero if none specified). Must be popped off 
stack before AST exit. 


3. When a MARK TIME directive is issued, an AST service entry 
point can be specified in the DPB. If specified, when the 
indicated time interval has elapsed, an AST occurs with the 
task's stack as follows: 


SP+16 == Event flag mask word for flags 1-16 

SP+14 -- Event flag mask word for flags 17-32 

SP+12 -=- Event flag mask word for flags 33-48 

SP+10 -= Event flag mask word for flags 49-64 

SP+06 -- PS of task at AST (interrupt), 

SP+04 == PC of task at AST (interrupt), 

SP+02 == Task's directive status (virtual zero), 

SP+00 -- Event Flag number (or zero if none 
specified). Must be popped off stack before 
AST exit. 


4-7 
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If a task is to be notified of PDP-11/45 floating point 
hardware exceptions, a SPECIFY FLOATING POINT EXCEPTION AST 
directive is issued, and following floating point exceptions 
will cause AST's to occur with the task's stack as follows: 


SP+20 -= Event flag mask word for flags 1-16 

SP+16 == Event flag mask word for flags 17-32 

SP+14 <= Event flag mask word for flags 33-48 

SP+12 -- Event flag mask word for flags 49-64 

SP+10 -- PS of task at AST (interrupt) , 

SP+06 == PC of task at AST (interrupt), 

SP+04 -— Task's directive status (virtual zero), 

SP+02 <= Floating point exception code, must be popped 
off stack before AST exit, 

SP+00 -- Floating point exception address, must be 
popped off stack before AST exit. 


For SPECIFY RECEIVE AST, nothing is placed on the stack. The 
actual RECEIVE can be performed by the AST service routine. 


The following are some general notes on the characteristics and use of 


AST's,. 


1. 


36 


De 


6. 


Two directives, INHIBIT AST RECOGNITION and ENABLE AST 
RECOGNITION, allow AST's to be queued for subsequent 
execution during critical periods. If AST's occur while AST 
recognition is inhibited, they are queued (FIFO), and are 
processed when AST recognition is enabled. 


If an AST occurs while another AST is being processed, it is 
queued (FIFO), and is processed when the preceding AST 
service is completed unless AST recognition was disabled by 
an AST service routine. 


If an AST occurs while an SST is being processed, the SST 
service routine execution is not distinguished from task 
execution, and is interrupted for execution of the AST 
service routine. 


If an AST occurs while the related task is suspended, the 
task remains suspended after execution of the AST service 
routine unless explicitly resumed by the AST. 


If an AST occurs while the related task is waiting for an 
event flag setting (WAITFOR directive), the task remains in a 
wait state after execution of the AST service routine unless 
an appropriate event flag is set by the AST or other routine. 


If an AST occurs while the related task is in execution, the 
task is interrupted for the execution of the AST service 
routine. This interrupt is transparent to the task unless 
the trap service routine changes the context of the task. 


If an AST occurs while a task is checkpointed, the task 
remains checkpointed and the AST is queued for execution 
after the task is reloaded. 


4.2.3 Processor Priorities 


Seven processor priorities are used by the PDP-ll, as described in the 
PDP=-11 Processor Handbook. Peripheral device interrupt service 
routines run at processor priority levels four through seven. In 
addition, software modules that cannot be interrupted run at priority 
level seven for short periods of time. 


Priority levels zero through three are used by the system as operation 
indicators; i.e., no software interrupts occur, and therefore, no 
precedence is implied or invoked by levels zero through three. 


Level zero is used exclusively for task execution. If a segment fault 
occurs at level zero, a system trap is caused if the task has a 
service routine to handle it. Otherwise, the task is aborted. 


Level one is used for the servicing of trap type instructions, e.g., 
EMT IOT, TRAP, and is used for the following: 


1. The processing of system directives (EMT 377s), 


2. The causing of a synchronous system trap if a trap-type other 
than BPT trap executes at priority one or the priority of the 
interrupt service routine, whichever is higher. 


Level two is used for the recognition of system events. These events 
are indicated in the system event recognition flag called .SERFG and 
are recognized only when returning to task execution, e.g., from an 
interrupt or from a directive. System events are significant event 
declarations, clock ticks, and power failure recoveries. 


Level three is used for execution of routines that cannot be 
interrupted by significant event recognition or clock tick 
recognition, but that can be interrupted by peripheral device 
interrupts, e.g., the system subroutine to dequeue a request for a 
device handler task. In these cases, the level can be set to three by 
any means, but it must be lowered to zero by transferring control to 
subroutine ..ENBO to allow recognition of system events that might 
have occurred while running at priority level three. The system trace 
debugging routine also runs at level three. 


APPENDIX A 
SYSTEM LISTS AND TABLES 


RSK130 ee RESTLENT EXECUTIVE MACRO 0@718 24"APRe75 12:56 PAGE 10 
EXEC MODULE ONE em SYMBOLIC DEFINITIONS 


“78 9 TPD == TASK PARTITION DIRECTORY 

a79 ’ 

rT) 9 THE "TPO" YS aA FIXED LIST OF ENTRIES DESCRIBING EACH PARTITION IN A 
48i 1 SYSTEM, THIS DIRECTORY IS CREATED BY THE SYSTEM CONFIGURATION, 

482 1 ROUTINE (SYSGEN) COASISTING OF ENTRIES OF THE FOLLOWING FORMAT? 

483 ’ 

484 COBRA T.PNs8O8 3 WO. AB (B AB) em PARTITION NAME CFIRST bKALF) 

48S 9 WD, B81 (8B 2) ee PARTITION NAME (SECOND HALF) 

486 oreees T,BAsEO4 3 WD, B2 (8B OU) we 1/6UTH BASE ADORESS OF PARTITION (IN BYTES) 
a8] 6AG006 T.PZes26 3 WO, @3 (B G6) == I/HUTH SIZE OF PARTITION CYN BYTES) 

488 OS0A12 T.FwWeeid 3 WO, @4 (B 10) w= PARTITION FLAGS WORD ; 
489 OAve12 TeHPesi2 3 WO. OS (B 12) ©@ 1/6UTH BASE ADR OF FIRST HOLE, OR VERO YF AO HOLES. 
492 oeeeld T RFesiG y WO, 06 (8B 12) e= MRL LISTHEAD (FORWARD LINKAGE) 

a9) wADR16 T,RBS516 3 WO, O7 (B 14) == MRL LISTHEAD (BACKWARD LINKAGE) 

492 yore T.CFseed » WO, 18 (8B 28) w= CTL LISTHEAD CFORWARD LINKAGE) 

493 vAZG22 T,CBzs22 39 WO, 11 (8 22) we CTL LISTHEAD CRACKWARD LINKAGE) 

494 ’ 

495 eev224 T,SZs2z2u WSIZE CIN BYTES) OF TPD ENTRIES 

&96 ) 

4g] r) FLAGS WORD BIT OCEFINITIONS? 

498 1 

499 cO0eo1 TF. UCas2a00e1 #{0@) SET IF USER CONTROLLEO PARTITION, 

5292 vegege TF, OUsSs2atage2 ¢{01) SET IF OCCUPIED USER CONTROLLED PARTITION, 

581 etuedga TF. YSzs00¢an4 9{@2) SET IF A TIME SHARED PARTITICN 


3?2 O8UP10 TF, ACBEOOIG19 9{03] SEY IF A TIME SHARED PARTITICN 8 ACTIVE 


t=v 


RSX11D e* RESICENT EXECUTIVE MACRO 0A7T1Q@ 24=APRe7S $2156 PAGE 11 
EXEC MODULE UNE |= SYMBOLIC DEFINITIONS 


5@4 s GCD == GLOBAL COMMON DIRECTORY 

5@S 3 

SM » GLOBAL COMMCN AREAS ARE SHARABLE AREAS OF MEMORY FOR USE AS 

$27 » LIBRARIES, CR FOR COMMON DATA STORAGE, 

$@6 + TRE "GCC" IS aA LINKED LIST OF ENTRIES DESCRIBIAG EACH GLOBAL COMMON 
5a9 + BLOCK IN A SYSTEM, THIS LIST IS CREATED BY INSTALL 

510 s ANDO CONSISTS OF ENTRIES OF THE FOLLOWING FORMAY, NOTE THAT GCN TYPE NOOFS 
211 1 ARE CREATED BY INSTALL FOR THE PURE AREAS OF MULTICUSER TASKS, BUT 
Sie s THESE NCOES ARE NOT LINKED INTO TRE GOD, BUT ARE POINTED TO RY THE 
513 » TASKS’ STD NODES, 

Sia § 

$15 9 WO, 88 (8 08) w= FORWARD LINK 

Sie » WO, @1 (B @2) == BACKWARD LINK 

517 O20004 G,BNzs04 3 wO, 92 (8 @4) == COMMON BLOCK NAME (6 CHAR IN RADI ¥ SH, 2eWORHS) 
S18 CABA12 G,B8aseli® 3 wO, O4 (B 18) @= $/64UTHK BASE ADDRESS OF COMMON BLOCK 

519 e%2012 GeCZ=ze12 5 wO, OS (B 12) @= 1/6UTH SIZE OF COMMON BLOCK 

520 BA@014 G.CTee14 3 wD, 66 (B 14) w= CREATION TIME (TWO WORDS! YEAR, MOATH/DAY) 
$21 e20020 G.GSs2heSBywD, 18 (8 20) == GLOBAL AREA STATUS 

$22 oevsel G,9Azz21 3 (B 21) @= STARTING APR 

$23 080822 G,OTes2e2 3 wO, tt (8 22) |= OWNER IDENTIFICATION (UIC) 

524 CA8224 G,POsm2u 3» WO, 12 (B 24) w= GLOBAL AREA TPD ADDRESS 

525 206026 G,FBex2b 3 WO, 13 (8B 26) |= FLAGS BYTE 

$26 000027 G,Ole=e7 3 (B 27) =~ CISK JADICATOR 

Se7 000830 G,AC=z=z30 » WD, 14 (B 38) @= ACTIVE REFERENCE COUNT (BYTE) 

526 200031 G,ICex3i 3} (CB 31) |= INSTALLED REFERENCE COLAY (BYTE) 

529 020032 G,NAzss32 79 WD. 15 (8B 32) == 1/0 NODE ADDRESS 

530 202034 G,DAws34 3 WO. 16 (B 34) ©= GLOBAL AREA DISK ADORESS 

$31 ’ 

53e sTHE FOLLOWING ARE GLOBAL AREA STATUSES? 

533 ’ 

S3a CA6080 GS,.NULE290 *GLOBAL AREA NOT IN USE 

535 000002 GS,LROQS=g2 #LOAD REQUEST QUEUED 

536 @@0204 GS.LRSeeQ4 *#LOAD REQUEST SUCCEEDED 

537 6292086 GS, LRFS=SQ06 sLOAD REQUEST FAILED 

536 090052 GS, RRQE=SQ52 #RECORD REQUEST QUEUED 

539 200054 GS,RRSSsQ54 sRECORD REQUEST SUCCEEDED 

$4Q 000056 GS.RRFEBQ56 #RECORD REQUEST FAILEO 

$44 ’ 

$42 ’ 

$43 0A20040 6.822840 *SIZE CIN BYTES) OF GCD ENTRIES 

S44 ’ 

545s 1 FLAGS wCRO BIT DEFINITIONS 

S46 ; ’ 

$47 020001 GF. Ele=Qe0ae1 1(@0) EXISTENCE INDICATOR (SET WHEA LIB OR COMMON LOADED) 
548 we20ve2 GF. Liss@goeo2 9(@1) LIBRARY COMMCK INDICATOR ew iL TB @8COM 

549 080204 GF Rlestegeeu 9(@2) LIBRARY RELOCATABILITY INDICATOR oo SEY FOR PIC CODE 
552 000212 GF. NW8s000010 2(03) SET WHEN NON@POWAER HAS WRITE ACCESS 


$51 200020 GF. NR®2090020 9(@4) SET WHEN RONPOWAER HAS READ ACCESS 


RSX11C0 #= RESICENT EXECUTIVE 
EXEC MCDULE ONE ee SYMBOLIC CEFINITIONS 


553 

554 

555 

556 

557 

$56 

559 OBOE? 
S6e 28002 
561 20003 
562 OA0AG4 
$63 oouade 
564 090812 
565 CAVA12 
566 CAaea 148 
$67 020016 
568 w200 22 
569 “2ve2e2 
570 020824 
571 C2GA26 
572 @2@o25a 
$73 2eea32 
574 O7Oe3u 
575 

576 

577 

$78 

$79 CA82356 
58 C@e24a 
58) 022242 
582 C2ue4h 
563 08B742 
584 e2seue 
585 

586 CAGZ44 
587 V2C7U6 
588 cA02esa 
589 2AGAS2 
590 “002252 
59) Q20053 
592 o@v2su4 
593 @20256 
594 

595 

596 WEBQ62 


MACRO Coe71e 


U,CNs308 
U,UNSss@e2 
U,FBs3@3 
U,Cis2@4 
U,C2ez06 
U,~C3s510 
U,Cusale 
U,AFzE14 
U,RPsezi6 
U,HAsB20 
UexCesee 
U,RFes24 
U,RB=Betb 
U,TVes3e@ 
U,1Pex3e 
U,DAss34 
’ 


t PHYSICAL UNITS 


| 

U,VAsz36 
U,UIssu@ 
U,PCesud 
U,GCeRdi 
U,VPsede 
U,Cresd2 


U,ARss44 


U,DACPSE46 


U,ACPEs50 
U,TF23S2 
U,PR=25S2 
U.FO#ssS$3 
U,LBHEESG 
U,LBNGES6 


’ 
U,SZ8z62 


’ 
§ 
§ 
’ 
U 
’ 
, 
J 
] 
5 
’ 
‘ 
, 
, 
$ 
' 


wO, 
wO, 


WO, 
WO, 
WO, 
WO, 
WO, 
wO, 
WO, 
wo, 
wD, 
wD, 
wo, 
wD, 
wO,. 


wO,. 
wD, 


wO, 


wl, 
wO, 
wo, 
wO, 
wO, 


wO. 
wD, 
wo, 
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PUD ©=* PHYSICAL UNIT OIRECTORY 


THE "PUD" IS A FIXEC LIST CF ENTRIES DESCRIBING EACH PKYSICAL DEVICE®@ 
UNIT IN A SYSTEM, 


THIS LIST IS CREATED BY THE SYSTEM CONFIGURATJON 
CONSISTS OCF ENTRIES CF THE FOLLOWING FORMATS 


ROUTINE (SYSGEN) AND 


08) 
#2) 
03) 
64) 
#6) 
1@) 
12) 
14) 
16) 
28) 
22) 
24) 
26) 
3@) 
32) 
34) 


DEVICE NAME (2 ASCII CHARS) 

UNIT NUMBER (CBYTE) 

FLAGS (BYTE) 

CHARACTERISTICS WORD ONE (DEVICE INDFPEANCEAT TyOrcaToRs) 
CHARACTERISTICS WORD TWO (DEVICE DEPENDEAY INDICATORS) | 
CHARACTERISTICS WORD THREE COEVICE DEPENDENT INOTCATORS) 
CHARACTERYSTICS WORD FOUR (SIZE CF BLOCK, BUFFER. | INE) 
ATTACH FLAG CAYL NCDE ADDRESS OF ATTACHING TASK) 
REDIRECT POINTER 

HANDLER TASK ATL NODE ADORESS 

COUNT OF EXPRESS REQUESTS IN QUEUE 

UNIT REQUEST DEQUE LISTHEAC (FWD PNTR) 

UNIT REQUEST DEQUE LISTKEAD (B8KD PATR) 

INTERRUPT TRAP VECTOR ADDRESS _ 

INTERRUPT PRIORITY (CIN BITS S17) 

fOEVICE PAGE ADDRESS! 


ARE CONSIDERED "VOLUMES" BY THE FILES SYSTEM, AND THE 
1 REMAINDER OF THE PUD 


17 
22 


ai 


ENTRY IS 


36) 
4@) 
4@) 
ui) 
2) 
42) 
43) 
uu) 
46) 
58) 
52) 
§2) 
53) 
§4) 
56) 
68) 


#SIZE 


A "VOLUME CONTROL BLOCK®, 


ADDRESS OF VOLUME COATROL BLOCK EXTENSTOA 
USER IPEATIFICATION COOE Cure) 

UIC PROGRAMMER CODE 

UIC GROUP CODE 

VOLUME PROTECTION WORD 

CHARACTERISTICS FLAGS 

RESERVED BYTE 

ACCESS RIGHTS FLAGS WORD 

DEFAULT ACP NAME, RACS@ (FIRST_WCRD) 
STD ENTRY ADDRESS OF CURREAT ACP 
TERMINAL FLAGS WORD | 

TERMINAL PRIVILEGE BYTE 

TERMINAL FORMS BYTE | : 
HIGH ORDER = TOTAL # OF BLKS FOR DEVICE 
LOW ORDER» TOTAL # OF BLOCKS FOR DFVICE 
RESERVED WORD 


CIN BYTES) OF PUD ENTRIES 


597 i 


598 ' FLAGS BYTE BIT CEFINITIONS 

599 t 

620 orang UF, ROE=048  AAKKKAEAAaERRRTEMPOCRARY WAkeRRKAR Ree eRHeRee 

621 C222ee@ UF RKES2Q0 9 (7) SET WHEN KANDLER TASK YS DECLARED RESIDEKT, 

ote 020102 UF. TLE=10@ s (6) SET WHEN FKANOLER TASK RECOGAIZES LOAD ANB RECORD 
603 eegeua UF, CFLE=sQug s (5) SEY WHEN DEVICE 8 OFFLINE 

o0u ] 

625 ’ BIT DEFINITIOAS FCR CHARACTERISTICS WORD OAE 

606 ’ 

627 oACZA1 UC. RECS&900001 (001 SEY IF RECORD ORTENTED DEVICE (VIZq, Tle LP» CRI 
608 090802 UC.CCLEze0eae2 3(81) SET IF CARRIAGE CONTROL DEVICE (VIZ... TT LP) 

629 o2e00u UC. TTYSBQhaPAu (82) SET IF TTY DEVICE (VIZ... KSR. LASO) 


RSX110 ©@ KESICENT EXECUTIVE MACRO 00710 24°APR@75 12:56 PAGE i201 
EXEC MODULE CME em SYMBOLIC CEFINITIONS 


012 eevAie ; UCeOIR®=90g019 2{03) SET IF DEVICE IS A DIRECTORY DEVICE 

61) wAeree UC.SDI=Se89020 3:(84) SET IF DEVICE I8 A SINGLE DIRECTORY DEVICE 
612 Croeue UC.SQOssa¢anue 1(85] SEY IF DEVICE 8 A SEQUENTIAL DEVICE. 

613 2O24UE2 UC. INBE=Q0Q4U00 14003 [98] SET IF THE DEVICE 18 INTERMEDYATE. BUFFERED 
614 Cei1ave uC.SwLeseaigae +(09) SET IF THE DEVICE 18 SOFTWARE WRITE LOCKED 
615 o22200 UC. ISPE=Q@200¢ [101 SET IF DEVICE 18 INPUT SPOCLED 

616 Queena UC.OSPE=a@ugee 3(111 SET IF DEVICE I$ OUTPUT SPOOLED 

617 o1erae UC.PSESza19000 18(12] SET IF DEVICE IS PSEUDO DEVICE 

616 veveor UC.COMESQ20000 1£(13) SET IF DEVICE IS COMMUNICATICNS CHANNEL 
619 049000 UC.Fiilesguapon sf14) SET IF DEVICE YS FYLESe44 

620 197o0v0 UC.MNTEZ1A9B0@ £({15) SET IF DEVICE YS MOUNTABLE 

621 ’ 

e2e ’ BIT DEFINITIONS FOR CHARACTERISTICS WORD TWO 

623 ’ . 

6264 QA@OAGu UC .wCKSEQ00G004 +s{G2) SET IF A READ AFTER WRITE CHECK YS REQUIRED 
625 ’ 5 . 

626 ’ BIT DEFINITIONS FOR VOLUME CHARACTERISTICS BYTE U.CH 

627 ’ 

628 220220 CH. OF F=2200 sVOLUME YS OFFeLINE 

629 680108 CH. FORS=10Q sVOLUME I8 FOREIGN 

636 C2004 CH.UNLS=4@ sOISMOUNT PENDING 

63) 080020 CH, NATERQO PATTACKH/DETACH NOT PERMITTED. 

032 020012 CH NDCES40 9DEVICE CONTROL FUACTIONS NOY PERMITTED 

633 w8v001 CH LABSSy sVOLUME IS LABELED TAPE 

o34 ’ 

635 ’ 

o36 ’ BIT DEFINITIONS FOR TERMINAL PRIVILEGE BYTE 

037 8 

636 QA0001 UT, PReel SET IF TTY IS PRIVLEGED 

639 e2eede UT. SL&E2 #SET IF TTY IS SLAVED 


64g 200004 UT LGead sSET IF TERMINAL IS LOGGED ON 


RSX110 e@ RESIOENT EXECUTIVE MACRO 00710 24"APRe75 12256 PAGE 13 
EXEC MODULE ONE = SYMBOLIC DEFINITIONS 


642 1 $TD== SYSTEM TASK DIRECTORY 

643 ) 

044 1 THE SYSTEM TASK DIRECTORY IS A MEMORY RESIDENT DIRECTORY OF ALL TASKS 
645 1 WHICH HAVE BEEN INSTALLED INTO A SYSTEM, THIS DIRECTORY CONSISTS OF TWO 
646 1 PARTS! (1) A FIXEO SIZE AREA OF ONE WORD FOR EACh TASK THAT MAY 

647 1 BE INSTALLED AT ANY TIME, AND (2) AN STD ENTRY FCR EACH TASK THAT Y8 
648 » INSTALLED, THE FIXED SIZED AREA 18 CALLED THE "ALPHA TABLE" AND 

649 t PROVIDES SPACE FOR AN ALPHABETICALLY ORDERED CONTIGUOUS LIST OF POYNTERS 
656 1 TO STD ENTRIES TO FACILITATE SEACH FOR STD ENTRY BY TASK NAME, 

651 1 EACH STO ENTRY YS OF THE FOLLOWING FORMAT? 

652 ’ 

653 ezorva S,TNsaQ0 3 WO. O88 (B 4) ©= TASK NAME (6 CHAR IN RADIX@SA, 2 WORDS) 

054 9 WO, @1 (B @2) ©= (SECOND HALF OF TASK NAME) 

655 eeuoou S,TOesgu y wD, @2 (B OU) == DEFAULT TASK PARTITION (TPD ADORESS) 

056 eaveee S,Fwe=sQ@6 7 *D, @3 (B 06) ©= FLAGS WORD 

057 200010 S.0Peaif® + WO, @4 (B 10) == DEFAULT PRIORITY (BYTE) 

058 wAQA1I $,Olse11 3 (8 11) == SYSTEM OISK YNDICATOR (BYTE) 

659 erea212 S$,LZe#l2 3 WO, @5 (8 12) == 1/64TH SIZE OF LOAD IMAGE 

662 UAI814 S,TZs214 7 WO, @6 (B 16) ©= 1/64TH MAX TASK SIZE 

661 222016 S,AVem16 9 WD, 27 (B 16) == NUMBER OF ACTIVE VERSIONS OF TASK (BYTE) 
662 202017 S.PVenl7 3 (8 17) e= TASK POOL LIMIT PER VERSION (BYTE) 

663 220020 S,PUsm20 7 WO. 18 (B 20) ©= TASK POOL UTILIZATION 

664 200022 S,RFes2e 3 WO. 11 (B 22) em RECEIVE DEQUE LISTHEAD (FWD PATRY 

665 @euo2u S.RBes2u 3 WO, 12 (B 24) em RECEIVE DEQUE LISTHEAD (BKG PATR) 

666 202026 $.0L2826 3 WO, 13 (B 26) == LOAD IMAGE FIRST BLOCK NUMBER (3P@BITS) 

667 s WO. 14 (B 30) (SECOND HALF OF DISK ADDRESS) 

668 eeeese S,GCss32 7 WO. 15 (8 32) ©= BEGINNING OF GCD POINTER AREA 

069 q 

078 ) 

671 1 THE SYSTEM DISK INDICATOR SPECIFIES WHICH 1/0 REQUEST QUEUE 18 ; 
672 1 TO RECEIVE A "LOAC TASK IMAGE" REQUEST, BY PROVIDING A "PUD ENTRY YACEX®S 
073 1 £.Gee A ZERC WOULD INDICATE THE REQUEST QUEUE FOR THE DEVICE@UNIT 

674 1 REPRESENTED BY THE FIRST (ENTRY ZERO) PUD ENTRY, 

675 t 

676 ' FLAGS WCRO BIT DEFINITIONS 

677 ' 

678 B20801 SF.24e8000001 1(881 STD IS 24 WORDS LONG COEFAULT I8 16) 

079 eezeue SF.FXeeQa@oe2 13{01) SET WHEN TASK IS FIXED IN MEWORY 

68% weeegs SF.RMzE090004 +[02) SET WHEN STD I8 TO BE REMOVED 

684 600010 SF.7Oss0a0010 1(03) SET WHEN TASK 18 DISABLED 

682 eevoe2e SF,BFea000020 1(04) SET WHEN A TASK I8 BEING FIXED IN MEMORY 

683 eeeeua SF.xT#eeQeg0aua 5(05) SET WHEN A TASK 28 TO BE REMOVED ON ext? 

684 602100 SF.MUESOQG100 1(06) SET WHEN TASK 18 MULTI@USER 


685 200222 SF, PTe=0a0200 1(07) SEY WHEN TASK 18 A PRIVILEGED TASK 


L-W 


686 
687 
686 
689 
690 
691 
692 
693 
694 
695 


RSX110 e@ RESIDENT EXECUTIVE 


080400 
621202 
e200 
QA4208 
010eRA 
620800 
240000 


COLCKO 


SF.NTSB0004U20 1{@8) NETWORK ATTRIBUTE BIT 
SF, Rieseaiane 9(09) RESTRICTED USAGE LEVEL ONE (BACKGROUND BATCH JOBS) 
SF. R288002000 #(18) RESTRICTED USAGE LEVEL TWO CUNIMPLEMENTEDC) 
SF. XABE0GU000 1(11) SET WHEN TASK IS NEVER TO BE ABORTED 
SF. xX088010070 9{12] SET WHEN TASK J$ NEVER TO BE DISABLEN 
SF. XFeed20000 9(13) SET WHEN TASK I$ NEVER TO BE FIXED IN MEMORY 
SF, xCaezdutoad 9{14) SET WHEN TASK I8 NEVER YO BE CHECKPOINTED 
1(15) UNUSED BIT 


i] 
S,SIZe852, 9SIZE OF STO IN BYTES 
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697 
698 
099 
788 
701 
72 
T@3 
724 
705 
7186 
707 
708 
709 
710 
711 
Tile 


Ce280u 
C2886 
CABAL 
e@oe11 
C2012 
020013 
080014 
08@215 
O9O216 
038016 
088820 
00002} 
#00022 
220024 


220230 


ATL =© ACTIVE TASK LIST 


THRE "ATL" IS A PRIORITY ORDERED DEQUE OF "ATL*® NCDES FOR ACTIVE TASKS 
THAT HAVE MEMCRY ALLOCATED FOR THEIR EXECUTION, TRE TASKS REPRESENTED 
BY EATRIES IN THE ATL ARE EITHER MEMORY RESIDENT, OR A REQUEST FCR THEIR 
LOADING HAS BEEN GUEUVED, THE LISTHEAD FOR THIS DEQUE I8 IN THF SYSTEM 
COMPUNICATIONS AREA (SCOM), AND THE NODES ARE OF THE FOLLOWIAG FORMAT? 


9 WO, @@ (8 28) |= FORWARD LINKAGE 

9 WO, Of (B 82) e@ BACKWARD LINKAGE 

ps WD, @2 (B O4) w= NODE ACCOUNTING WORD (STD ENTRY ADR OF REQUESTOR! 
A ,ROssh, AW 
A. Tiseh.TIlswO, @3 (B 06) #= TY IDENTIFICATION © PUD ADDRESS 
A,RPsaid 3 wD, 84 (B 18) © TASK*S RUN PRIORITY (BYTE) 


A, Reais 3 (B 11) ©= TASK 1/0 IN PROCESS COUNT (BYTE) 

A,INesl2 y WO, @5 (B 12) == TASK I/0 PENDING COUNT (BYTE) 

A,Cguaid 3 (B 13) = SAVED STATUS OF CHECKPCINTED JASK 
A.MTBS14 3 WO, @6 (B 14) == TASK MARK TIME PENDING COUNT (BYTE) 
A,CPexi1S 3 (B 15) e= SAVED PRIORITY OF CHECKPOINTED Task (BYTE) 
A,HASB16 » WD. 07 (B 16) w= {/HUTH REAL AOR OF LOAD IMAGE 

ALNARBA,HA 4 ee 1/0 NODE ADDRESS WHEN TASK I8 IN MRL 

A, TSssh, SBy WD. 10 (8 20) == TASK STATUS (BYTE) 

A,ASsxel 3 (CB 21) |= AST INDICATOR (PREVIOUS STATUS) BYTE 


A, TDws22 9 WO, 11 (B 22) we SYSTEM TASK DIRECTORY (S70) ENTRY ADDRESS 
A,EFee2u » WO, 12 (8 24) o= TASK*°S EVENT FLAGS ({@32) 
9 WO. 13 (8 26) |= (SECOND HALF OF TASK*°S EVENT FLAGS) 
A.FMse30 3 WO, 14 (B 30) o© TASK°S EVENT FLAGS MASKS (64"BITS) 
WO. 15 (B 32) == (SECOND WORD OF FLAGS MASK) 
ee (THIRD WORD OF FLAGS MASK) 
WO. 17 CB 36) e@ (FOURTH WORD OF FLAGS MASK) 


~~ ws ww 
= 
i] 
es 
on 
se 
rn 
@ 
ue 
= 
Sd 


8-W 


727 
728 
729 
730 
731 
732 
733 
734 
735 
736 
737 
738 
739 
740 
741 
742 
743 
7446 
745 
746 
747 
746 
749 
780 
751 
782 
733 


RSX110 == KESICENT EXECUTIVE 


BA0048 
080042 
220044 
022046 


800852 
020054 
G220S6 


A,POssdd 
A, AFuszd2 
A, ABzsug 
A, TAsszub 


A,TFea2S2 
A,CFas54 
4,CBes56 
| 


iY 
’ 
’ 
’ 
5 
H 
' 
U 
’ 
’ 


wD, 
wo, 
WO, 
wd, 
wD, 


INITIALLY 


2 8.0L 


TASK*°S RUN PARTITION (TPD ADORESS) 
AST DEQUE LISTHEAD (FWD POINTER) 
AST DEQUE LISYHEAD (BKWO POINTER) 
TASK IMAGE DYSK ADDRESS | 

(SECOND WORD OF IMAGE ADORESS) 


CONTAINS CHECKPOINT ADRS IF TASK IS CHECKPOINTED 
bO. 25 (B 52 == TASK FLAGS . 
WO, 26 (B 5G) ©= CHECKPOINT TASK LIST FCRWARD POINTER 
wD. 27 (B 56) ©= CHECKPOINT TASK LIST BACKWARD POINTER 


TASK STATUS VALUES ARE DESCRIBED aT “asxorTé 


BEFCRE EXECUTION » THE 
FLAGS MASK WORDS ARE USED AS FOLLOWS: 


A.F¥4O == ADDRESS OF TASK LOAD 1/0 REQUEST DEQUE LISTHEAD, 
AeFYOu == TASK UIC. 


BITe8 IS SET WHEN THE LOW ORDER BYTE (BITS @=7) CONTAIN A. 
TERMINATION NOTIFICATION CODE (CODES DESCRIBED AT *se.cac’) 


BIT=9 IS SET WHEN 1/0 RUNDOWN MESSAGE ITS REQUIRED. 


’ 
’ 
§ 
’ 
’ 
’ 
’ 
§ ' . ? 
s AFTER TASK EXECUTION, °A.FMoO* IS SET AS FOLLOWS! 
’ 
' 
’ 
’ 
’ 
’ 
’ 


FLAGS WORD BIT DEFINITIONS 


MACRO DO710 24°AaPRe75 
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754 
755 
7156 
757 
758 
759 
7606 
763 
Tee 
763 
764 
765 
766 
167 
768 
769 


62020} 
otetve 
80004 
CVVA1A 
w@822 
GAoe4A 
200100 
2922 
©2@04a0 
221800 
v22002 
e24Agd 
010002 


B2BROA 


’ 

AP. CPsz0901 
AF, ROssege2 
AF, A0se0Q94 
AF, COs#82190 
AF. MCesO2a 
AF. GCa20u0 
AF, 1028100 
AF, ITz2200 
AF. GRa84Q0 


AF, BF ae1Q00 
AF. FXee82000 
AF. ASs2doaa 
AF RA&E1Q000 


q 
A SIZsz46, 


12:56 PAGE 


WHEN 
WHEN 
WHEN 
WHEN 
WHEN 
WHEN 
WHER 
WHEN 
WHEN 
WHEN 
WHEN 
WHEN 
WHEN 


1Ge{ 


TASK IS CHECKPOINTED 

TASK*S 1/0 IS BEING RUN DOWN 

TASK AST RECOGNITION JS INWYBITED 
CHECKPOINTING I$ DISARLEO  ~—| 

TASK IS MARKED FOR CHECKPOINTING 

TASK I8 HOLOING A COMMARD BUFFER 

TASK HAS AN 1/0 COMPLETION EVENT IN ITS AST QUEUE 
TASK HAS AN INTERMEDIATE TRANSFER IN PROGRESS 
TASK°S SHARED GLOBAL AREAS HAVE BEEN RELEASED 
A TASK IS TO BE FIXED 

A TASK I8 FIXED 

AN AST HAS BEEN DECLARED 

THERE IS A POTENTIAL RECEIVE AST 


OF ATL IN BYTES 


RSX110 e© KESIDENT EXECUTIVE MACRO 09710 24eAPRe75 12:56 PAGE 15 
EXEC MODULE CAE me SYMBOLIC CEFINITIONS 


771 ! 

7172 » MRL #©@ PERCRY REQUIRED LIST 

773 ’ 

774 1 THE "MRLY TS A PRIORITY ORDERED PEQUE OF "ATL*® NCDES FOR ACTIVE TASKS 
7T7§ 1 THAT REQUIRE MEMORY IN A PARTITION, EACK PARTITION HAS JTS OWN PRL, 
776 1 WHENEVER A NON®FIXED TASK RUNNING IN A PARTITION EXITS. AN | 

777 1 ATTEMPT YS MADE TO ASSIGN MEMORY TO THE FIRST CHIGHEST PRIORITY) 

778 1 TASK IN TKE LIST. IF MEMORY IS FOUND, THE TASKS NODE I8 

779 1 MOVED FROM THE "MRL" TO THE "ATL" OEFQUE, THE MRL LISTREAD Y8 IN 

782 9 TRE TPO EATRY FOR TRE CORRESPONDING PARTITION, 

781 ’ 


RSX110 == RESIDENT EXECUTIVE MACRO 00710 24UAPRe75 12:56 PAGE 1t6 
EXEC MOCULE ONE ee SYMBOLIC CEFINITIOANS 


783 , 
784 ’ 

785 t CTL == CHECKPCIANTABLE TASK LIST 

786 ’ 

787 9 ThE "CTL" IS A PRICRITY ORDERED CEQUE OF ENTRIES FOR CHECKPOINT ABLE 
788 1 TASKS TRAT ARE ACTIVE IN A PARTITION, EACH PARTITION HAS TTS OWN 
789 1 CTL, TRE CTL LISTHEAD IS IN THE TPD ENTRY FOR TRE CORRESPONCING 
798 1 PARTITION, 

794 1 THE CTL YS REALLY JUST A RELINKIAG CF TKE ATL, PCWEVER. AND FAS 

192 1 NC UNIQUE NCDES OR FORMAT CF ITS Own, bye tk tics : 

793 1 THE CTL FORWARD AND BACKWARD POINTERS ARE THE LAST TWO WORDS IN 
794 1 THE ATL ACDE, AND » CCNSEQUENTLY. AEGATIVE OFFSETS MUST BE DFFINEO 
795 1 SO TRAT PARAMETERS MAY BE REFERENCEC WITH RESPECT YO TRE CYL FORWARE 
796 s POIATER, 

797 ’ 

798 177732 K ROSBA,ROA.CE 

799 177764 K,PDssA,PDeA, CF 

82a 177734 K, RPSBA,RPOA.CE 

821 177735 K, IRSEA,IR@ALCE 

88e 177736 K, IN@BA,ITN@ALCE 

83 177740 K MT SMA, MTOALCE 

B@4 77741 K, CPszA, CPeA. CF 

885 177742 K, NASBA, NAoA, CF 

826 177742 K HASBA,HAwA,CF 

827 177744 KTSs#A,TSHA CF 

628 177745 K, ASSuA,ASoA.CF 


829 177746 K, TOesd, TDeA,CF 


OT-WV 


812 
811 
812 
813 
814 
615 
816 
817 
616 


RSX110 ee RESIDENT EXECUTIVE 


177758 
177754 
177732 
177766 
177770 
177772 
177776 
177737 


K EFamA, EFoA. CF 
K,FMesd,FMoA, CF 
K,TIseaA,Tlea. Cr 
K, APuewh, APoA.CF 
K, ABewdA, ABeAL CF 
K, TAswa, Tawa. CF 
K,TFEsed, TFaACE 
K.CSexh,CSuAa, CF 
9 
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621 
822 
823 
824 
825 
826 
827 
826 
829 
830 
631 
632 
833 
634 
835 
836 
837 
836 
639 
64g 
841 
642 
B43 
644 
845 
646 
647 
848 
849 
850 
851 
8S2 
853 


088004 
2A0006 
oteela 
OAOO11 
202012 
G004013 
@90014 
288016 
22020020 
80822 
200022 
20023 
208824 


0A2040 


DIRECTIVE, 


9 wD, 
' WD, 
5 WO, 
R, TOssh\,AW 
R,AT2206 9 WO, 
R,PReei® 3 wO, 
R,OPsei! 3 
R,~LUsa#ie 7 WD, 
R,FNeays 3 
R,FCaei4 » wo, 
R,SBas16 3 wd, 
R,AEss20 3 YO, 
R,UIse2e 3 WO, 
R,PCss2e 3 
R,GCe223 3 
R,PBew2u 3 WD, 
9 WO, 
5 WO, 
9 WO, 
5 WO, 
+ WO, 
R,POss4d 9» wD. 


ea 
a1 
02 


03 
Qu 


a5 


6 
a7 
18 
11 


12 
13 
14 
is 
16 
17 
28 
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IRQ ~= I/0 REQUEST GUEUE 


18 


THE "IRQ" TS A PRIORITY ORDERED DEQUE OF 1/0 REQUEST NODES WITH ITS 
LISTKEAD IN THE PUD EXTRY OF THE PHYSICAL UNIT FOR WHICH THE 17/0 
REQUEST WAS QUEUEDO. 


EACH PHYSICAL UNIT HAS ITS CWN 1/0 REQUEST QUFUE, 


@8) 
2) 
64) 


@6) 
18) 
11) 
12) 
13) 
14) 
16) 
20) 
22) 
22) 
23) 
24) 
26) 
38) 
32) 
34) 
36) 
4@) 


1/0 REQUEST NCDES ARE CREATED AND GUEUED PRIMARILY BY THE "QUEUE 1/0" 
HCWEVER, THE EXEC ALSO CREATES 1/0 REQUESTS TO1 

(1) LOAD s TASK IMAGE, (2) RECORD A TASK IMAGE [CHECKPOINTING)» ANP 
(3) TO RUNDCWA 1/70 CN AN EXIT°ED TASK, 
THE FOLLOGWIAG FORMAT, 


1/0 REQUEST NODES ARE OF 


FORWARD LINKAGE 
BACKWARD LINKAGE 
NODE ACCOUNTING WORD (STD ENTRY ADR OF REQUESTOR) 


ATL NODE OF REQUESTOR wen 
PRIORITY (BYTE) 

OPB SIZE (BYTE) «aw 

LOGICAL UNIT NUMBER (BYTE) 

EVENT FLAG NUMBER (BYTE) 

1/0 FUNCTION COOE 

VIRTUAL ADDRESS OF STATUS BLOCK 
VIRTUAL ADORESS OF AST SERVICE ENTRY 
USER IDENTIFICATION CODE 

PROGRAMMER CODE 

GROUP CODE 

PARAMETER W4 

PARAMETER w2 

PARAMETER #3 

PARAMETER #4 

PARAMETER #5 

PARAMETER #6 

PUD POINTER FOR THIS REQUEST 


TI-W 


854 
855 
856 
657 
658 
859 
860 
661 
862 
863 
864 
865 
666 
867 
868 
869 
870 
671 
872 
873 
874 
875 
876 


RSK13D == RESIDENT EXECUTIVE 


878 
879 
680 
661 
862 
883 
684 
865 
886 
687 


888 


869 
896 
891 
892 
893 
694 
695 


220042 
OdOO44 


222854 
092056 


220201 
Q80°B2 
C2004 


B800B4 
080006 
200012 


R, 


ELseue 5 WO, 21 (8 U2) |= ERROR LOG BUFFER POINTER/SELAG 


RewAesuuU 9 WO, 22 (B UU) em FLAG BYTE FOR EXEC 


Re 
R. 


§ WO. 22 (B 4S) == WORK AREA FOR DEVICE HANDLERS 
WO. 23 (B U6) em WORK AREA FOR DEVICE HANDLERS 
24 (B S@) == WORK AREA FOR DEVICE HANDLERS 
WO. 25 (8B 52) == WORK AREA FOR DEVICE HANDLERS 
1BesS4 3 #0, 26 (8 54) == INTERMEDIATE BUFFER AOCRESS 
UBeES6 7 WO. 27 (8 56) ©@ USER BUFFER ADDRESSCINTERMEDIATE TRANSFER) 


~~ we we 
= 
Oo 
e 


THE LOw ORDER THREE@BITS OF THE 1/0 FUNCTION CODE ARE USED BY TRE SYSTEM 
AS FCLLCWS: 


’ 
RF. ITesQotaey 1(@) e= RESERVED FOR FUTURE USE 
RF. XResoogane2 r{1) == "EXPRESS REQUEST" 

RF. IResoogneu 1(2) ©= RESERVED FOR FUTURE USE 


wee WHEREVER AN I/O REQUEST IS QUEVED BY THE "QUEUE t/0" BYIRECTIVE, JRE 
DPB SIZE AND THE REQUESTOR’S ATL NODE ADDRESS ARE RECORDED IN THE I/C 
REQUEST NODE, WHENEVER AN I/O REQUEST IS QUEUED aS A RESULT OF ANOTHER 
DIRECTIVE (VIZ., "REQUEST" CAUSING A TASK IMAGE TO BE LOADFD), THE OPB 
SIZE AND THE REQUESTOR®’S ATL NODE ADORESS ARE SET TQ ZERO. YRHUS, BOTH 
BOTH THE DPB SIZE AND THE ATL NODE ADDRESS ARE ALSO "EXEC REQUEST" 
INDICATORS, 


MACRO 0@71@ 24"APRe75 12:56 PAGE 19 
EXEC MODULE ONE @= SYMBOLIC DEFINITIONS 


C 


CKQ #= CLOCK QUEUE 


THE CLOCK QUEUE IS A DEQUE CONSISTING OF ONE NCDE FOR EACH OPERATION 
SCHEDULED TC BE PERFORMED AT SOME FUTURE TIME, A "SCHEDULE NELTAH 
TIME" IN THE FIRST NODE CIF ANY) OF THE CLOCK QUEUE 18 DECREMENTED 

AY EACH CLOCK TICK UNTIL TRE NODE "COMES DUE", AY WHICH TYME THE 
INDICATED OPERATION IS PERFORMED, CLOCK QUEUE NCDES ARE LINKED 

IN TRE CROER IN WHICH THEY WILL COME DUE, AND THE SCHEOULE DELTA@TIME 
IN EACH NODE CEXCEPT THE FIRST) IS RELATIVE TO THE SCHEOULE TYME 

OF TRE PREVIOUS CLOCK QUEUE NODE. CLOCK QUEUE NCDES ARE OF THE 
FOLLCWING FORMAT, 


WO, 02 =e FORWARD LINKAGE 
WO. @1 == BACKWARD LINKAGE | 
WO. @2 == NODE ACCOUNTING WORD (STD ENTRY ADR OF REQUFSTOR) 


»TOeeh\, An 


C.ATse06 3 WD, @3 == ATL NODE ADORESS OF REQUESTOR 


Cc 


eSOsB12 7 WO, 04 @= SCHEDULE DELTA IN TICKS (64@BITS) 


cLT-W 


8% ; 9 WD, 85 wee (LOWER ORDER HALF OF SCHEDULE DELTA) 


897 QO00G14 C.RTesi4 7 wO, @6 wm REQUEST TYPE INDICATOR & UNUSED BYTE 

898 1 

a99 030016 C.FMmel6 3 WO, 87 == (MT) FLAG MASK (BIS SRC) 

909 0a0029 C,Fawes20 3 wO, 186 == [MT] FLAGS WORD ADR (BYS DST ADR) 

901 @@u@22 C,FNezee 3 WO, 11 we MT) EVENT FLAG AUMBER ; 

9282 oMeeed C,AEsm2u 3 WO, 12 w= EMT} VIRTUAL ADORESS OF AST SERVICE ENTRY 

963 9 (5 UNUSED wORDS) 

904 ’ 

905 220016 C.RIs#ei6é 3 WO, @7 © [TS] RESCHEDULE INTERVAL IN TICKS (64eBxTS) 

926 p WO, 18 e= [TS] CLOW ORDER HALF OF RESCHEDULE INJERVAL) . 
927 QB8%22 C,Reee22 3: WO. 11 =e (78) STD ENTRY ADR OF REQUESTED TASK (RP FOR °,REOS*) 
928 oee2u C.R3me24 9 WO, 12 s© (TS) TPD ENTRY ADR, OR ZERO. (RB FOR °.REQS*) 

929 220026 C.RUsw26 » WO, 13 == [TS) RUN PRIORITY, OR ZERO (R4 FOR °.REOS8*) 

918 DAZAIe C,UrIss3@ 3 WO, 14 @= (78) UIC INDICATOR FOR °,REQS” : 

9ii 200032 C.TIse3s2 3 WO, 15 we (TS) YI IDENTIFICATION FOR °. REQS® 

912 9 €2 UNUSED wORDS) 

913 ’ 

914 1 (MT) == MARK TIME NODE ENTRIES 

915 s (TS) e* TASK SCHEDULING NODE ENTRIES 

916 f) 

917 9 REQUEST TYPE INDICATORS: 

918 1 

919 { @ w= MARK TIME 

928 Q20ug2 TM.SLESuga #SUB CODE FOR AN INTERNAL TIME SLICE 

921 r) i 2° TASK SCHEDULING (SINGLE SHOT) 

922 r] 2 ee TASK SCHEDULING WITH PERIOOIC RESCHEDULING 

923 § 

924 r) NOTE e= THE CLOCK QUEUE SCAN ROUTINE IN "CANCEL SCHEOULEN REGQUESTS*" 
925 ’ ASSUMES TASK SCHEDULING IF NON@ ZERO REQUEST TYPE INDICATOR, 


CT-W 


RSK1)C c= KESIDENT EXECUTIVE 


927 
928 
929 
930 
931 
932 
933 
934 
935 
936 
937 
936 
939 
940 
9u4 
942 
9443 
9uU4 
94s 
946 
947 
946 
949 
956 
951 
952 


CA206 
048010 
0@G212 


22Q4OA 
eee4uel 
221002 
020003 
200004 
201407 
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EXEC MODULE ONE s© SYMBOLIC DEFINITIONS 


FORMAT, 
5 WO, 
y WO, 
y WD, 
Y,TT22@6 9» WO, 
Y,AEsziO 3 wd, 
Y,Pisele » WO, 
p WO, 
9 wD, 

} 


02 
At 
He 
03 
0u 
8s 
e5 
@6 


ETC, 


ASQ #= AYNCHRONOUS SYSTEM TRAP QUEUE 


THE "ASQ" IS A DEQUE CFIFO), WITH LISTHEAD IN ATL ENTRIES, CONSISTING 
OF CNE NODE FOR EACH AST (ASYNCHRONOUS SYSTEM TRAP) TO BE FXFCUTED FCR 
THE TASK DEFINED BY THE STD ENTRY, ASQ NODES ARE OF THE FOLLOWING 


FORWARD LINKAGE 

BACKWARD LINKAGE 

ACCOUNTING WORD (STD ENTRY ADDRESS OF CHARGFD TASK) 
ASY TYPE & NUMBER OF PARAMETERS an 

AST ENTRY POINT 

AST PARAMETER 1 

AST PARAMETER 2 

AST PARAMETER 3 


1 
1 #e THE AST TYPE & NUMBER OF PARAMETER DEFINITIONS ARE AS POLLOWS? 


§ 
YF MTSsO4¢<ugges 
YF, 1Cezilecuages 


> 
> 


YF FESS2+<ugane> 
YF, PRes3+<uggng> 
YF REssuecuggeg> 
YF PCEET¢<CUAQ%3> 


tMARK@TIME (PARAMETERS EVENT FLAG NUMBER) 

11/0 COMPLETION (PARAMETER? STATUS BLOCK ADDRESS) 
1F.P, EXCEPTICN (PARAMETERS: EXCEPTION CODF & ADMRESS) 
sPOWER RECOVERY (NO PARAMETERS) 

sRECEIVE QUEUE*D (NO PARAMETERS) 

tCOMMUNICATIONS AST 


RSX110 ee RESIDENT EXECUTIVE 


954 


MACRO 09718 2U4eAPRe75 12156 PAGE 21 
EXEC MODULE ONE #2 SYMBOLIC DEFINITIONS 


7] 
955 9 SRQ ee SEND/RECEIVE QUEUE 
956 ] 
987 9 THE "SRO" IS a DEQUE (FIFO), WITH LISTHEAD IN STO ENTRIES, CONSISTING 
958 s ONE NODE FOR FACH BLOCK OF DATA "SENT" (VIA "SEND" OR "SEND & REQUEST" 
989 9 DIRECTIVES) YO THE TASK DEFINED BY THE STD ENTRY. ROS NODES ARE OF 
968 ¢ THE FOLLOWING FORMAT, 
961 r) 
962 9 WO, 868 w= FORWARD LINKAGE 
963 9 WO, O21 em BACKWARD LINKAGE 
964 Cnaveaa DOD, SIlexh,AW 9 WO, G2 (8 G4) w= SENDER ID CNAW) 
965 020806 O,TIseh,7TI 9 wO, 83 (8 86) == TI INDICATOR 
966 O222819 0, PR=s819 1 WO, 8&4 (B 18) == PRIORITY OF SEND 
967 O811 0,8Ssa11 ] (8 11) &= BUFFER STZE (WORDS) 
968 @A0012 D.0iz812 2 WD. @5 (8 12) ee FIRST WORD OF DATA BLOCK 
” RSX110 |©= RESIDENT EXECUTIVE MACRO 00710 24°APRe75 12256 PAGE 22 
EXEC MODULE ONE == Sy*BOLIC DEFINITIONS 
978 s MCR w= MCR COMMAND BUFFER 
971 , 
972 1 THE MCR COMMAND BUFFER IS A 96 BYTE BUFFER THAT KOLOS THE DATA 
973 ¢ FOR A REQUESTED MCR FUNCTION. THE SUFFER YS SET UP BY THE MCR 
974 2 OISPATCH FUNCTION AND YS RETURNED TO THE POOL BY THE °GET MER 
975 s COMMAND LYNE DIRECTIVEAFTER THE INFORMATION HAS BEEN PASSFD 
976 s YO TRE MOR FUAKCTION, THE BUFFERS ARE LINKED TO THE MCR BUFFER 
977 a LIST BY THE MCR DISPATCH FUNCTION, 
9786 1 
979 § 9 WD. O@ em FORWARD LINKAGE 
986 ] 1 WD. Of == BACKWARD LINKAGE 
981 1 WD. 82 wee NODE ACCOUNTING WORD 
962 020006 M,TNs86 9 WD. @3 == SECOND HALF OF MCR TASK NAME 
983 0290010 mM, TIe2#10 9 WD. @4 we TY ADDRESS OF MCR FUNCTION 
984 B@A2012 M,BCssi2 9 WO. @5 © NO. OF BYTES IN COMMAND LINE 
985 240014 MBF ee14 s WO. @6 ©@ START OF DATA AREA IN BUFFER 


APPENDIX B 


GLOSSARY 


ATL (Active Task List) A priority-ordered list of Active 
Tasks used to drive the system. 
The ATL is a deque consisting of 
one node for each Active Task in 
the system. 


CLOCK QUEUE The Clock Queue is a deque 
consisting of one node for each 
item to be done at some time in the 
future, such as scheduling of Tasks 
(Via the SCHEDULE and MARK TIME 


Directives), and rescheduling of 
Tasks (Clock interrupt service 
routine). The nodes are linked in 


the order in which they come due. 


COMMON BLOCK, INTERNAL An area of contiguous memory within 
a partition, available only to the 
Task in the partition during its 
residency. 


COMMON BLOCK, SYSTEM An area of contiguous memory, 
defined at System Generation time, 
where data can be stored and 
referenced by all Tasks. A SYSTEM 
COMMON BLOCK is referenced by using 
a COMMON name matching a SYSTEM 
COMMON BLOCK name and declaring 
that COMMON as SYSTEM COMMON to the 
Task Builder. 


DEFAULT PRIORITY A priority given to a Task during 
Task Building or Task Installation 
that is used when a priority is not 
specified and the Task's execution 
is requested or scheduled. 


DEQUE A double-ended queue consisting of 
a listhead and list elements 
(nodes), circularly linked by both 
forward and backward pointers. 
Deques or linked lists are used to 
store system information. 


DEVICE HANDLER A Task in the RSX-11D system which 
drives or services an I/O device. 
Handler tasks are activated using 
the Queue I/O directive. 


DIRECTIVE See SYSTEM DIRECTIVE 
DISK-RESIDENT TASK A Task which normally resides on 


the disk and is brought intoa 
memory partition to execute. 


DPB (DIRECTIVE PARAMETER BLOCK) 


EVENT FLAG 


EXECUTIVE 


I/O RUNDOWN 


LISTHEAD 


LINKED LIST 


LUN (LOGICAL UNIT NUMBER) 


LUT (LOGICAL UNIT TABLE) 


MCR (MONITOR CONSOLE ROUTINE) 


A block of up to 12 #£4(decimal) 
contiguous words containing 
information needed in processing a 
System Directive. 


One of 64 bits associated with a 
Task, which is’ set or cleared to 
indicate that a particular 
Significant Event has occurred. 


The Executive coordinates all ac- 
tivities in the system including 
Task scheduling, I/O supervision, 
resource allocation, and interactive 
operator communication. 


A process which delays the avail- 
ability of a partition until all 
transfers to and from that partition 
have been stopped or have been al- 
lowed to complete. I/O RUNDOWN is 
invoked when a Task is terminated 

by the Executive or by the ABORT 
MCR Function Task and has outstand- 
ing transfers pending to/from its 
partition. 


A 2-word memory block with forward 
and backward pointers pointing to 
the next and previous list node or 
to itself if empty. The listhead 
is a reference point in a circularly- 
linked list. 


A deque consisting of nodes and 
a listhead used to store system 
information. An empty list con- 
sists of only a listhead. 


Logical Unit Numbers are used to 
represent logical I/O device units 
rather than physical units. Each 
Logical Unit Number is represented 
by an entry in the Logical Unit 
Table. 


A block of contiguous memory with a 
l-word entry, or slot, for each 
Logical Unit Number. When a LUN is 
assigned to a physical device unit, 
the corresponding LUT slot contains 
the address of the appropriate 

Physical Unit Directory node. 


The MCR allows the user to com- 
Municate on-line with the system 
from the console Teletype. The MCR 
consists of the Resident MCR Task, 
whicn accepts user's commands, and 
the MCR Functions, which actually 
carry out the indicated requests. 


MEMORY-RESIDENT TASK A Task which has been fixed-in-memory 


or which is assembled as part of the 
Executive. 


MONITOR CONSOLE The control Teletype of the RSX-11D 
system where MCR Function requests 
may be issued by the operator. 


NODES The list elements of a deque. All 
nodes (of dynamic lists) consist of 
the listhead, followed by data 
(list elements). 


PARTITION An area of contiguous memory within 
which Tasks are executed; defined 
at System Generation time. 


PUD (PHYSICAL UNIT DIRECTORY) A table constructed during System 
Generation to describe the I/0 
devices and units in the system. 
When a logical I/O number is 
assigned to a physical unit, the 
device and unit are set ina LUT 
entry corresponding to the LUN. 


POOL (POOL OF EMPTY NODES) Empty 17-word nodes for use in any 
deque. The pool is generated by 
System Generation from a core area 
not specified for other use. 


SIGNIFICANT EVENT An event which results in the 
scanning of the active task list. 


The following events are considered 
significant events: 1) I/O queuing, 
2) normal I/O request completion, 

3) a task request, 4) a scheduled 
RUN, SCHEDULE, or SYNC coming due, 
5) a Mark Time expiration, 6) a task 
resumption (Resume directive), and 
7) a task exit(Exit directive). 


STD (SYSTEM TASK DIRECTORY) A directory of all tasks installed 
in the system. 


SYSTEM GENERATION The process through which the user 
tailors the RSX-11D system to best 
fit his requirements. 


SYSTEM DIRECTIVES Instructions to the RSX-11D 
Executive toa perform special 
functions, such as I/O, etc. 


TASK A program written by the user or 
supplied by Digital which is built 
via the Task Builder, installed in 
the system via the Monitor Console 
Routine, and scheduled and. executed 
on a priority basis. 


TKB (TASK BUILDER) The Task Builder program is used to 
build Task files from relocatable 
binary files. 
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1 elYTLE GIOMAC = GIOSYM MACRO DEFINITION 

2 3 ALTERED SUNDAY 24eNOVO74 $3300 

3 3 ALTERED THESDAY 28eJANe75 15258398 

4 3 ALTERED THURSDAY BO6-FEB-7§ 15358 

§ 3 ALTERED MONDAY 24eFEBo75 153403098 BY ED MARISON 

6 3 ALTERED TUE 25—-MAR@75 152338 EDIT & +841 

7 H 

8 3} «eeee ALWAYS UPDATE THE FOLLOWING TWO LINES TUGETHER 

9 eIDENT /0304/ 

12 AvdI3na OI, vERs@304 

11 i 

12 3 COPYRIGHT 1974,1975, DIGITAL EQUIPMENT CORP,, MAYNARD MASS, 
13 

14 3 THIS SOFTWARE IS FURNISHED TO PURCHASER UNDER A LICENSE FOR USE 
15 3 ON A SINGLE COMPUTER SYSTEM AND CAN BE COPIED (WITH INCLUSION 
16 3 OF DEC'S COPYRIGHT NOTICE) ONLY FOR USE IN SUCH SYSTEM, EXCEPT 
17 3 AS MAY OTHERWISE BE PROVIDED IN WRITING BY DET, 

18 

1° } THE INFORMATION IN THIS DOCUMENT 18S SUBJECT TO CHANGE WITHOUT 
2? } NOTICE AND SHOULD NOT BE CONSTRUED AS A COMMITMENT sY OIGITAL 
21 § EQUIPMENT CORPORATION, 

2? 
23 3 DEC ASSUMES NO RESPONSIBILITY FOR THE USE OR RELIABILITY 
24 3 OF ITS SOFTWARE ON EQUIPMENT WHICH IS NOT SUPPLIED HY DEC, 

26 3 

24 3 

2? 3 

28 ve 

29 3 MACRO TO DEFINE STANDARD QUEUE I1/0 DIRECTIVE FUNCTION VALUES 
3” 3 AND TOSd RETURN VALUES, TO INVOKE AT ASSEMBLY TIME (wITH LOCAL 
31 3 DEFINITION) USE?s 

32 } 

33 } arasys sDEFINE SYMBOLS 

34 H 

35 3 TO ORTAIN GLOBAL DEFINITION OF THESE SYMBOLS USE? 

34 3 

3? 3 QIOSVS OEFSG 9SYMBOLS DEFINED GLOBALLY 

38 ; 

3¢ 3 THE MACRO CAN BE CALLEO ONCE ONLY AND THEN 

4a 3 REDEFINES YYSELF AS NULL, 

ai Jeo 

42 

43 eMACRO GIOSYS S$S$$GBL,S$SMSG 

44 allf ION, <SSSGBL>,<DEFS$G>, eGLOBL OI,.VER 

45 olF ION, <$S$MSG>,<DEFSS> 

aA SSEMAX2Q 

47 $$MSGs1 

48 elFF 

49 S$$MSG3Q@ 
50 2ENDC 
$1 eMCALL TLOERRS 
52 TOEKR$ S$$S8GCBL #I1/0 ERROR CODES FROM HANDLERS, FCP, FCS 
53 eMCALL DRERFS 
54 ORERR$ S$SS$GRL SDIRECTIVE STATUS WORD ERROR CODES 
55 olf DIF,<SSSMSG>,<DEFSS> 

56 eMCALL FILIOS 


57 FILIOS S$S$SGBL SDEFINE GENERAL GI/O FUNCTION CODES 


QIOMAC = OTOSYM MACRO DEFINITIO MACRO NU71A 25eMARe75 14223 PAGE Iiel 


58 eMCALL SPCIOS 

59 SPCIOS $$$GBL DEVICE DEPENDENT I/0 FUNCTION CODES 
60 eMACRO QIOSY$ ARG, ARG1L,ARG2 RECLAIM MACRO STORAGE 

63 eENDM O10SYS 

62 eENOC 


63 e&NOM QIOSYS 
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65 
66 
67 
68 
69 
70 
71 
72 
73 
74 
75 
76 
77 


=e we we Ge Ge wes WO 


oMACRO 


eMCALL 
elf 


eee GBL#} 


oT FP 


oe eGBLs® 


eENOC 
lif 


QOEFINE THE ERROR CODES RETURNED BY DEVICE HANDLER AND FILE PRIMITIVES 
IN THE FIRST WORD OF THE I/0 STATUS BLOCK 
THESE CODES ARE ALSO RETURNED BY FILE CONTROL SERVICES (FCS) IN THE 
BYTE F,ERR IN THE FILE DESCRIPTOR BLOCK (FOB) 
THE BYTE F,ERRo1 JS @ IF F,ERR CONTAINS A HANDLER OR FCP ERROR CODE, 


IOERRS S$SSGBL 
eIOER, DEFINE 
I0N,<S5$SGBL>,<DEF$G> 


NDF, $SMSG,SSMSG8O 


» SYSTEM STANDARD CODES, USED BY ALL FUNCTIONS 


oTOER, 
elOER, 
eITQER, 
oIOER, 
eT OER, 
eIOER, 
»ITOER, 
»lOER, 
eIOER, 
elOER, 
elOER, 
aIOEF, 
elOER, 
2 lOER, 
eIOER, 
elOER, 
el0ER, 
INNER, 
elOER, 
elOER, 
elNER, 
eINER, 
elOER, 
eTOER, 
e1OER, 
eTOER, 
elTOER, 
eIOER, 


} 


IE,BAD,-@1.,<8AD PARAMETERS> 
IE, IFC,-O2e,<INVALID FUNCTION CODE> 
IE,ONR,=@34,<DEVICE NOT READY> 

IE, VER, ©04,,<PARITY ERROR ON DEVICE> 
IE,ONP,=05,,<HARDWARE OPTION NOT PRESENT? 
IE.SPC,-064,<ILLEGAL USER BUFFER> 
TE,DNA,=074,<DEVICE NOT ATTACHED> 
TE,UVAA,*08.,<DEVICE ALREADY ATTACHED> 
IE,DUN,*09.,<DEVICE NOT ATTACHABLE> 
IE,EOFy-10e,<END OF FILE DETECTED> 
IE,EOVe"tle,<END OF VOLUME DETECTED> 
TE,WLK,-12—e,<wRITE ATTEMPTED TO LOCKED UNIT> 
1E,DA0,"130,<DATA OVERRUND 
IE,SRE,-14,,<SEND/RECELVE FAILURE> 
1E,AB0,"15—9,<REQUEST TERMINATED> 
IE.PR1,"160,<PRIVILEGE VIOLATION? 
1E.RSU,17¢,<SHARABLE RESOURCE IN USE> 

IE, OVR,"18e,<ILLEGAL OVERLAY REQUEST> 
IE,GYT,-19¢,<0DD BYTE COUNT (UR VIRTUAL ADDRESS)> 
IE.6LK,*26e,<SLOGICAL BLOCK NUMBER TOO LARGE> 
IE.MOD,"210,<INVALIDO UDC MODULE #> 

TE ,CON» "220, <UDC CONNECT ERROR> 

IE,B86,"56.,<BAD BLOCK ON DEVICE> 
IE,STK,-58-,<NOT ENOUGH STACK SPACE (FCS OR FCP)> 
IE, FHE,=59,,<FATAL HARDWARE ERROR ON DEVICE> 
1E,60T,762e,<END OF TAPE DETECTED> 
1E,OFL,-65e,<DEVICE OFF LINE> 

IE,BCC,)=66¢,<8L0CK CHECK OR CRC ERROR> 


b FILE PRIMITIVE CODES 
U 


eTOER, 
eTOER, 
»TOER, 
» OER, 


TE,NOD,9235,,<CALLER'S NODES EXHAUSTED? 
IE,0FU,924.,,<O0EVICE FULL> 

TE, 1FU,9254,<INDEX FILE FULL? 
TE.NSF,=26,,<€NO0 SUCH FILE> 
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122 sIOER, IJE,LCK,~275,<LOCKED FROM WRITE ACCESS> 
123 eIOER, IE,HFU,~28.,<FILE HEADER FULL> 

124 eIOER, IE,WAC,"29,,<ACCESSED FOR WRITE> 

125 ~IOER, IE,CKS,°30,,<FILE HEADER CHECKSUM FAILURE> 

126 ~IOER, IE,wAT,=31,,<ATTRIBUTE CONTROL LIST FORMAT ERROR> 
127 wIOER, TE,RER»-32e,<FILE PROCESSOR DEVICE READ ERROR> 

128 »IOER, IE,WER, ©335,<FILE PROCESSOR DEVICE WRITE ERROR> 

129 eIOER, IE,ALN,"34e,<FILE ALREADY ACCESSED ON LUN> 

130 eIOER, IE,SNC,~35.,<FILE ID, FILE NUMBER CHECK> 

131 eIQER, IE.SQC,"364,<FILE 10, SEQUENCE NUMBER CHECK> 

132 ~I0ER, IE,NLN,=374,<NO FILE ACCESSED ON LUN> 

133 ,IOER, IE,CLO,-365,<FILE WAS NOT PROPERLY CLOSED> 

134 wIOER, I6,DUP,-574,<ENTER © DUPLICATE ENTRY IN DIRECTORY> 
135 alQOER, TE,6VR,-63,,<8AD VERSION NUMBER> 

136 ~lIQOER, ITE.B8HD,"64,,<KHAD FILE HEADER? 

137 eIOER, IE,EXP,=75a,<FILE EXPIRATION DATE NUT REACHED> 

138 wIOER, IE,BTF,=765,<8AD TAPE FORMAT> 

139 

140 3 

141 s+ FILE CONTROL SERVICES CUDES 

142 H 

143 

144 ~IQER, IE,NBF,©39,,<OPEN = NO BUFFER SPACE AVAILABLE FOR FILE> 
145 eIQER, JE RBG, @40.,<ILLEGAL RECORD SIZe> 

146 wIOER, IE,,NBKe@416,<FILE EXCEEDS SPACE ALLOCATED, NO BLOCKS> 
147 eIOER, TE, ILL, -42e,<ILLEGAL OPERATION ON FILE DESCRIPTOR BLOCK> 
148 eIOER, IE,B8TP,"43,,<BAD RECORD TYPE> — 

149 eIOER, TEeRAC, 9446,<ILLEGAL RECORD ACCESS BITS SET> 

1590 »IOER, IE,RAT,-45,,<ILLEGAL RECORD ATTRIBUTES BITS SET> 

151 eIOER, TE,RCON,@46,,<ILLEGAL RECORD NUMBER = TOO LARGE> 

15? eIQER, TE,MAK,-47,,<MULTIPLE BLOCK READ/WRITE = NOT IMPLEMENTED YET> 
153 ~IOER, TE6,20V,=45.,<RENAME = 2 DIFFERENT DEVICES> 

154 elO0ER, IE, FEX,#49,,<RENAME = NEW FILE NAME ALREADY IN USE> 
155 »IOER, IE,BOR,=50,,<BAD DIRECTORY FILE> 

156 eIQOER, TE,RNM, 5S) a,<CAN'IT RENAME OLD FILE SYSTEM> 

157 eIOER. T&,.BD1,"52.,<8AD DIRECTORY SYNTAX> 

158 ~IOER, IE,FOP,-53.,<FILE ALREADY OPEN> 

159 eIQER, T€,8NM,°54,,<8AD FILE NAME> 

160 eIOER, IE,B80V,°55_,<BAD DEVICE NAME> 

161 eIOER, IE,NFI1,-60,,<FILE ID WAS NOT SPECIFIED> 

162 eIOER, TE,180,-61.6,<ILLEGAL SEQUENTIAL OPERATION> 

163 eIOER, JE.NNC»"774,<NOT ANSI 'O! FORMAT BYTE COUNT> 

164 : 3 

165 } NETWORK ACP CODES 

166 ; 

167 eIOER, I6€,4ST,-67,,<NO AST SPECIFIED IN CONNECT? 

168 elOER, TE,.NNN,©66,,<NO SUCH NODE> 

169 ~IOER, IE,NFW,=69,,<PATH LOST TO PARTNER> ##¥@1 THIS CODE MUST BE ODD 
170 eLOER, IE,8LB,"76.,<BAD LOGICAL BUFFER> 34001 

171 eIQDER, TE,TMM,=71e,<TOO MANY OUTSTANDING MESSAGES> 

17? ~IOER, IE€,NOR»p=72e,<NO DYNAMIC SPACE AVAILABLE> 

173 eIOER, IE,CNR,@73_,<CONNECTION REJECTED> 

174 »IMER, TE.TMO,=74e,<TIMEQUT ON REQUEST> 

175 eIMER, TJE,NNL»=78e,<NOT A NETWORK LUN> $4001 

176 

177 


U 
178 3 SUCCESSFUL RETURN CODES@== 
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179 3 

180 

181 DEFINS 15, PND,¢06, OPERATION PENDING 

182 PEFINS 18,SUC,%81, IOPERATION COMPLETE, SUCCESS 

183 DEFINS 18.8V,+05, JON A/D READ, AT LEAST ONE BAD VALUE 
164 dwAS READ (REMAINDER MAY BE GOOD), 
185 3840 CHANNEL IS INDICATED BY A 

186 NEGATIVE VALUE IN THE BUFFER, 

187 

168 

189 3 

19a 3 TTY SUCCESS CODES: 

191 3 

492 

193 DEFINS 1S,CR,<15e¢498e1> s;CARRIAGE RETURN WAS TERMINATOR 

194 MEFINS 18,69C,<33"d4dBel1> JESCAPE (ALTMODE) WAS TERMINATOR 
195 
196 
197 
198 
199 
20a 
201 
22 eeueee 

2¢3 olf EQ,$S$MSG 
204 eMACRO YOERRS A 
205 eb NOM IGERRS 
26 eENDC 

207 eENOM TOERRS 


hevede 


THE NEXT AVAILABLE ERROR NUMBER IS! 979, 
ALL LOWER NUMBERS ARE IN USEL3 


Se Ge we we te te 


b=) 
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289 3 : 

210 > DEFINE THE DIRECTIVE ERROR CODES RETURNED IN THE DIRECTIVE STATUS WORD 
211 ; 

212 ’ FILE CONTROL SERVICES (FCS) RETURNS THESE CODES IN THE BYTE F,ERR 
213 3 OF THE FILE DESCRIPTOR BLOCK (FOB), TO DISTINGUISH THEM FROM THE 
214 3 OVERLAPPING CODES FROM HANDLER AND FILE PRIMITIVES, THE BYTE 

215 > F,ERRot IN THE FOB WILL BE NEGATIVE FOR A DIRECTIVE ERROR CODE, 
2164 3 7 

217 MACRO ORERRS &SSGAL 

218 eMCALL ,GTOE,,DEFINS 

719 oF IDN,<S$S$S§GHL>,<DEFSG> 

220 oe OBL a1 

221 oIFF 

22? 00. GhL 80 

223 eENDC 

224 oll NDF, S$3SMSG,SSMSG8O 

228 ’] ; 

226 3 STANDARD ERROR CODES RETURNED BY DIRECTIVES IN THE DIRECTIVE STATUS WORD 
227 3 

228 eVTOE, TE UPN, -81,,<INSUFFICIENT DYNAMIC STOKAGE> 

229 eQTO0E, TE,INS,-82,,<SPECIFIED TASK NUT INSTALLED> 

238 eQTOE, IE,ULN, -85,,<UN=-ASSIGNED LUN> 

231 eQTOE, TE HWK, -06,.,<HANDLER TASK NOT RESIDENT> 

232 eQTOE, YE,ACT, -07.,<TASK NOT ACTIVE>D 

233 eUTOE, TEITS» -OBe,<DIRECTIVE INCONSISTENT WITH TASK STATE> 
234 eQIOE, IE,CKP,-10,,<ISSUING TASK NOT CHECKPOINTABLE> 

235 ; 

236 3 

237 : 

238 eQTUE, 16,487, -8H.,<DIRECTIVE ISSUED/NOT ISSUED FROM AST> 
239 sQIOE, TELNL»-90.,<LUN LOCKED IN USE> 

24a eGIOE, JTE,lO0U,"92e,<INVALID DEVICE OR UNIT> 

241 eGQIOE, TE,ITI,-93.,<INVALID TIME PARAMETERS> 

242 eGTOE, YEeIPRs995.,<INVALID PRIORITY ( ,GT, 250,)> 

243 eQTOE, TE,ILU,-96.,<INVALID LUN> 

244 eQTOE, TEIEF,*97,,<INVALID EVENT ( ,GT, 64,)> 

245 eQTOE, IE, ADP, =98,,<PARY OF DPB OUT OF USER!S SPACE> 

246 eQTOE, IE,.SO0P,*99,,<DIC OR DPB SIZE INVALID> 

247 H 

208 + SUCCESS CODES FROM UIRECTIVES = PLACED IN THE DIRECTIVE STATUS wORD 
249 ’ 

259 OEFINS IS,CLR,O JEVENT FLAG WAS CLEAR 

251 ¥FROM CLEAR EVENT FLAG DIRECTIVE 
252 DEFINS IS,SET,2 JEVENT FLAG waS SEY 

253 }FROM SEY EVENT FLAG DIRECTIVE 

254 DEFINS IS,SPD,2 1TASK WAS SUSPENDED 

255 ’ 

256 ; 

257 wIF EG,SSMSG 

258 »MACRO DRERRS A 

259 »ENDM DRERPS 

260 eENDC 


261 eENDM DRERRS 
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263 
264 
265 
266 
267 
268 
269 
27a 
271 
272 
273 
274 
275 
276 
27/7 
278 
279 
28u 
281 
262 
283 
264 
285 
286 
287 
268 
289 
29a 
291 
2y2 
293 
294 
295 
296 
297 
298 
299 
30a 
301 
302 
303 
304 
305 
3@6 
307 
3a8 
309 
319 
311 
31? 
343 
344 
315 
316 
347 
348 
319 


§ DEFINE THE GENERAL G1/0 FUNCTION CODES » DEVICE INDEPENDENT 
} 


»MACRO 
eMCALL 
oIF 


oe GBLs} 


o lFF 


ee  GBLOO 


eENOC 


FILIOS S$SSGBL 
eWORD,,DEFINS 


ION, <SSSGBL>, <DEFSG> 


’ GENERAL QI/O QUALIFIER BYTE DEFINITIONS 


eWORD, 
eWORD, 
so ewORD, 


U 
} EXPRESS QUEUE 


3 


eWORD, 
eWORD, 
oWORD, 
ewORD, 
eWORD, 


10,X%,601,00¢ 
10,9,002,000 
10,,804,808 


COMMANDS 


TO, KIL, 812-000 
IO,RDN, 022,008 
IO, UNL ,042,680 
10,L7K,056,008 
TO,RTK, 060-890 


U 
* GENERAL DEVICE HANDLER CODES 


eWORD, 
eWORD, 
ehORD, 
»wORD, 
wWORD, 


TO, WLB, 006,881 
10,RL8,008,002 
T0,L0V,010,002 
IG, ATT, 006,003 
10,DET,000,004 


3 OIRECTORY PRIMITIVE CODES 


WORD, 
eWNRD, 
eWORN, 


TO,FNA, 004,011 
10,RNA, 000,013 
I0,ENA, 800,014 


» FILE PRIMITIVE CODES 


«WORD, 
eWORD, 
eWORD, 
eWORD, 
eWORD, 
eWORD, 
2vORD, 
eNORD, 
eWwORD, 
eWORD, 
»WORD, 
eWORD, 
ehORD, 
eWORD, 


I0,CLN, 880,007 
TU,ACR, 000,015 
1G, ACW, 000,016 
10,ACE, 000,017 
10,DAC, 000,020 
10,RVB, 808,821 
TO,wV8,000,022 
IG,EX1,800,023 
10,CRE,J00,024 
10,0EL,080,825 
10,RAT, 000,026 
TO0,*AT, 000,027 
TO,APV,010,030 
TO0,APC,080,038 


JNO ERROR RECOVERY 


BQUEUE REQUEST IN EXPRESS QUEUE 


PRESERVED 


SKILL CURRENT REQUEST 
31/70 RUNDOWN 

PUNLOAD 1/0 HANOLER TASK 
HLOAD A TASK IMAGE FILE 
BRECORD A TASK IMAGE FILE 


sWRITE LOGICAL S8LOCK 
dREAD LOGICAL BLOCK 


#LOAD OVERLAY C(OISK DRIVER) 
PATTACH A DEVICE TO A TASK 
BDETACH A DEVICE FROM A TASK 


SFIND FILE NAME IN OIRECTORY 
BREMOVE FILE NAME FROM OIRECTOURY 
PENTER FILE NAME IN DIRECTORY 


SCLOSE OUT LUN 
sACCESS FOR READ 
dACCESS FOR WRITE 
PACCESS FOR EXTEND 
sOE“ACCESS FILE 

PREAD VIRITUAL BLOCK 
WRITE VIRITUAL BLOCK 
PEXTEND FILE 

ICREATE FILE 

IDELETE FILE 


BREAD FILE ATTRIBUTES 


PWRITE FILE ATTRIBUTES 
PPRIVILEGED ACP CONTROL 
DACP CONTROL 
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320 ’ 
321 eMACRO FILIOS A 
322 eENOM FILIOS 


323 »ENOM FILIOS 


OT-d 
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325 
326 
327 
328 
329 
338 
331 
332 
333 
334 
335 
336 
337 
338 
339 
340 
341 
342 
343 
344 
345 
346 
347 
348 
349 
35@ 
351 
352 
353 
354 
355 
356 
357 
358 
359 
36a 
361 
362 
363 
364 
365 
366 
367 
368 
369 
370 
371 
372 
373 
374 
375 
376 
377 
378 
379 
38A 
381 


§ DEFINE THE QI/0 FUNCTION CODES THAT ARE SPECIFIC TO INDIVIOUAL DEVICES 


eMACRO SPCIOS SSSGBL 


eMCALL 
elf 


eee GBLel 


e lFF 


oe GEL 28 


eENDC 


5 
» Q1/0 FUNCTION 


eWwORD, 
eWORD, 
eWORD, 
eWORD, 
ewORD, 
eWORD, 
«WORD, 
eWORD, 
«WORD, 
«WORD, 
eWORD, 
eWORD, 
eWwOkO, 
»WORD, 
eWORD, 
eWORD, 
2WORD, 
ewORD, 
WORD, 
e*ORD, 
eWORD, 
ewORD, 
e wORD, 
«WORD, 
ewORD, 
ekORD, 
ewORD, 
owORD, 
eWORD, 
eWORD, 
eWORD, 
eWwORD, 
e WORD, 
eWORD, 
eWORD, 
eWwORD, 
«WORD, 
eWwORD, 
eWORD, 
eWwORD, 
ewORD, 
aWORD, 
ewOROD, 


eWORO,,DEFINS 


ION, <SSSGBL>, <DEFSG> 


10, wlLV,108,001 
TO,wlLS,018,001 
TO. WNS, 020,001 
T0,RLV,1800,082 
TO0,RNC,8480,002 
T0,RAL, 010.962 
10,RNE,020,002 
10,R08.2800,002 
10,RHD,0180,002 
T0,RNS,020,082 
10,CRC,648,082 
10,R1C.008,885 
10, INL,8@00,085 
10,TRM, 010,005 
10, R8C,080,0696 
10,400, 0080,006 
TO, HOX, 018,006 
I10.F OX, 628,086 
310,SYN, 040,086 
10,RTC, 080,007 
10,8WD0,8080,005 
10,SP8,020,005 
10,SPF ,848,005 
IO,ENF , 086,086 
10,STC,100,005 
10,SEC,120,005 
10,RWU,148,005 
10.SM0, 160,005 
10,5A0,000,210 
10,S8S80,6080,011 
10,4S0,000,012 
10,SL0,000,0153 
TO,MLO, 008,014 
10,LED, 000,024 
10,S800,80808,025 
10,S0] ,000,026 
10,S8CS, 880,026 
10, REL, 200,027 
10,MCS,008,027 
10, 408,088,030 
10,CC1, 008,030 
10, M01,8800,031 
10,0C1,088,033 
TO0,XMT, 008,031 


CODES FOR SPECIFIC DEVICE DEPENDENT FUNCTIONS 


PWRITE LOGICAL REVERSE (DECTAPE) 
S(COMMUNICATIONS) WRITE PRECEDVED BY SYNC TRAIN 
BCCOMMUNICATIONS) WRITE, NO SYNC TRAIN 
DREAD REVERSE (DECTAPE) 

BREAD = NO LOWER CASE CONVERT (TTY) 
SREAD PASSING ALL CHARACTERS (TTY) 

yREAD WITHOUT ECHO (TTY) 

SREAD BINARY MODE (CARD READER) 
S(COMMUNICATIONS) READ, STRIP SYNC 
B(COMMUNICATIONS) READ, DON'T STRIP SYNC 
P(COMMUNICATIONS) READ, OON'T CLEAR CRC 
DREAD SINGLE CHANNEL (APC, ADOL, UDC) 
PCCOMMUNICATIONS) INITIALIZATION FUNCTION 
sCCOMMUNICATIONS) TERMINATION FUNCTION 
BREAD MULTICHANNELS (BUFFER DEFINES CHANNELS) 
s(CUMMUNICATIONS) SETMODE FUNCTION FAMILY 
F(COMMUNICATIONS) SET UNIT HALF DUPLEX 
(COMMUNICATIONS) SET UNIT FULL DUPLEX 
P(CCOMMUNICATIONS) SPECIFY SYNC CHARACTER 
SREAD CHANNEL © TIME BASED 

JREWIND (MAGTAPE, DECTAPE) 

IMAGTAPE, SPACE "N*® BLOCKS 

IMAGTAPE, SPACE "N*® EOF MARKS 

PMAGTAPE, WRITE EOF 

BMAGTAPE, SET CHARACTERISTIC 

IMAGTAPE, SENSE CHARACTERISTIC 

SREWIND AND UNLOAD (MAGTAPE, DECTAPE) 
IMAGTAPE, MOUNT & SET CHARACTERISTICS 
HUOC SINGLE CHANNEL ANALOG OUTPUT 

yUDC SINGLE SHOT, SINGLE POINT 

HUDC SINGLE SHOT, MULTIPOINT 

BUDC LATCHING, SINGLE POINT 

sUDC LATCHING, MULTI=POINT 

JLPS!4 WRITE LED DISPLAY LIGHTS 

JLPS11 WRITE OIGITAL OUTPUT REGISTER 
SLPS13 READ OIGITAL INPUT REGISTER 

sUDC CONTACT SENSE, SINGLE POINT 

ILPS11 WRITE RELAY 

SUODC CONTACT SENSE, MULTIPOINT 

SLPS11 SYNCHRONOUS A/U SAMPLING 

sUDC CONTACT INT © CONNECT 

SLPS11 SYNCHRONOUS DIGITAL INPUT 

sUOC CONTACT INT @ DISCONNECT 


BCCOMMUNICATIONS) TRANSMIT SPECIFIED BLOCK WITH ACK 


TT-o 


QIOMAC © QIOSYM MACRO DEFINITIO MACRO 00710 25-MAR-75 14323 PAGE 5-1 


382 
383 
364 
385 
386 
387 
388 
389 
390 
391 
392 
393 
394 
395 
396 
397 
398 
399 
4aa 
481 
462 
403 
404 
405 
406 
407 
4ge 
409 
410 
411 
412 
413 
444 
415 
416 
417 
418 
419 
420 
421 
422 
a23 
424 


eWORD, 
eWORD, 
eWORD, 
eWORD, 
eWORD, 
ewOoRD, 
eWORD, 
eWORD, 
eWORD, 
»WORD, 
eWORD, 
eWORD, 
eWORD, 
WORD, 
eWORD, 
eWORD, 
WORD, 
WORD, 
e WORD, 
WORD, 
ewORD, 
eWORD, 
2WORD, 
wOkO, 
»WORD, 
eWORD, 
eWORD, 
eWORD, 
eWORD, 
e¥ORD, 
e¥ORD, 
eWOROD, 
eWORD, 
eWORD, 
a wORO, 
WORD, 
eHORD, 
2WORD, 


»MACRO 
oENDM 
eENDM 


IO,XNA,80186,031 
10, HIS, 008,832 
T10,RCI, 800,852 
T0,RCV,8000,032 
10,.M00,0008,033 
10,CTI,000,033 
10,CON, 600,033 
10,CPR,818,835 
10,CAS,020,033 
T0,CRJ,048,9833 
10.CB80,118,035 
10,CTR, 210,033 
10,GN],010,035 
10,GL1,6020,035 
I0,GLC,838,635 
10,GRI,040,935 
T10,GRC,056-035 
10,GRN, 060,035 
10.CS8M,870,035 
1O,CIN, 100,035 
10,CBN,118,835 
10,CB0,120,035 
10,0T1,080,034 
10,018,0800,034 
I0,MDA,000,034 
IO,RTI,000,835 
10,CTL,000,035 
10.STP,0808,035 
IO,I1TI,080,836 
10, WPB,040,001 
10,RPB, 040,002 
10, SHT,016,005 
10,S8T,030,005 
10,SE™,940,005 
10,SNM,958,085 
10,CCT,060,805 
10,0C1,0970,085 
10,E€S8A,100,005 


SPCIOS A 
SPCIOS 
SPCIOS 


S(COMMUNICATIONS) TRANSMIT WITHOUT ACK 

SLPS11 SYNCHRONOUS HISTOGRAM SAMPLING 

yUOC CONTACT INT = REAO 

B(COMMUNICATIONS) RECEIVE DATA IN BUFFER SPECIFIED 
ILPS11 SYNCHRONOUS DIGITAL OUTPUT 

sUOC TIMER ~» CONNECT 

B(COMMUNICATIONS) COMMUNICATIONS CONNECT FUNCTION 
B(COMMUNICATIONS) COMMUNICATIONS CONNECT NO TIMEOUTS 
SCCOMMUNICATIONS) COMMUNICATIONS CONNECT WITH AST 
P(COMMUNICATIONS) COMMUNICATIONS CONNECT REJECT 
34801 (COMMUNICATIONS) COMMUNICATIONS BOOT CONNECT 
36881 (COMMUNICATIONS) COMMUNICATIONS TRANSPARENT CONNECT 
BCCOMMUNICATIONS) COMMUNICATIONS GET NODE INFO 
SCCOMMUNICATIONS) COMMUNICATIONS GET LINK INFO 
S(COMMUNICATIONS) GET LINK INFO CLEAR COUNTERS 
SC(COMMUNICATIONS) GET REMOTE NODE INFO 

940861 CCOMMUNICATIONS) GET REMOTE NODE ERROR COUNTS 
3801 (COMMUN,) GET REMOTE NODE NAME 

34861 (COMMUNICATIONS) CHANGE SOLO MODE 

3oO8W1 (COMMUN,) CHANGE CONNECTION INHIBIT 

34801 (COMMUNICATIONS) CIRCULAR BUFFER NCS 

34201 (COMMUNICATIONS) CIRCULAR BUFFER DDCMP 

sUDC TIMER = OITSCONNECT 

BCCOMMUNICATIONS) COMMUNICATIONS DISCONNECT FUNCTION 
FLPS11 SYNCHRONOUS D/A OUTPUT 

UDC TIMER = READ 

(COMMUNICATIONS) NETWORK CONTROL FUNCTION 

sLPS11 STOP IN PROGRESS FUNCTION 

sUDC TIMER © INITIALIZE 

$ RXO1 ~ FLOPPY OISK WRITE PHYSICAL BLOCK 

3 RX@} = FLOPPY DISK READ PHYSICAL BLOCK 

SSET HORIZONTAL TAB POSITIONS 

SSET SPECIAL TERMINATOR CHARACTERS 

BSET TERMINAL MODE (CHARACTERISTICS) 

SSENSE TERMINAL MODE 

sCONNECT TO REMOTE TERMINAL (AUTO DIALOUT) 
SDISCONNECT FROM REMOTE TERMINAL (HANGUP) 

BENABLE STATUS AST 


eT-O 
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426 
427 
428 
429 
438 
431 
432 
433 
434 
435 
436 
437 
638 
439 
440 
443 
442 
443 
444 
445 
446 
447 
448 
449 
450 
4§1 
4§2 
453 
454 
455 
456 
457 
458 
459 
460 
46! 
462 
463 
464 


—™) ~e @e “ee we 


== “© we Ww te 


HANDLER ERROR 


CODES RETURNED IN I/0 STATUS BLOCK ARE DEFINED THROUGH THIS 


MACRO WHICH THEN CONDITIONALLY INVOKES THE MESSAGE GENERATING MACRO 
FOR THE QIOSYM,MSG FILE 


elOER, SYM,LO,MSG 
SYM,LO 

GT,S3M8G 

elOMG, 
SYM,LO,<MSG> 


eIOER, 


1/0 ERROR CODES ARE DEFINED THOUGH THIS MACRO WHICH THEN INVOKES THE 


ERROR MESSAGE 


GENERATING MACRO, ERROR CODES ©4129 THROUGH 256 


ARE USED IN THE QIOSYM,MSG FILE 


CONDITIONALLY 


MACRO 
eWORD 
eASCIZ 
oEVEN 
allf 
2ENOM 


OI0E, SYM,LO,MSG 
SY™,L0 

GY,SSMSG 

2 lOMG, 

SYM, <L00128,>,<MSG> 


eGIOE, 

GENERATE DATA FOR WRITING A MESSAGE FILE FOR MO 
2I0MG, SYM,LO,MSG 

eal O> 

amSGa 


LT, AO<SSSMAX6<LO>>, SSSMAXB@AD<LO> 
sIOMG, 


DEFINE THE SYMBOL SYM WHERE LO 18 IS THE LOW ORDER BYTE, WI IS THE HIGH BYTE 


»MACRO 
DEFINS 
2ENDM 


eWORO, SYM,LO,HI 
SYM, <AN<H] #400eLO0>> 
eWORD, 


ONn3° 100008 2 
9$430 SAsOlo eeeoes | 


£4 39Vd CStwl SLouvwege O1400 OYSVW OISLINI439Q ONDVW WASOIO = JYNOTO 


C-13 


¥T-0 


QIOMAC = QIOSYM MACRO DEFINITIO 
SYMBOL TABLE 


IE,ABOe8 177761 G IE, IFus 
TE,ACT® 177771 G TE, ILL® 
IE,ADP= 177636 G Té,ILus 
TE,ALNS 177736 G IE, INSs 
TE,AST® 177660 G TE, IPRs 
TE,BA0® 177777 G TE,1S0Q8 
TE, BBE 177710 G TE,ITIs 
IE,8CCs 177676 G TE,IvSs 
TE,B801® 177714 G TE,L_CKs 
TE,80Re 177716 G TE,LNL® 
TE.B8OVe 177711 G IE,MAKs 
TE,BHDe 1777808 G TE,mOD# 
IE.8L8s 177672 G TE ,NBFs 
TE,BLKs 4177754 G Te ,NBKs 
TE,BNMe 177712 G TE ,NOR® 
TE,BTFs 177664 G TE, NFI® 
TE.8TPe 177725 G TE,NFWs 
TE,BVRe 177701 G TE,NLN® 
I€.8VYe 177755 G IE, NNC# 
IE,CKPs 177766 G TE ,NNL® 
TEeCKS® 177742 G TE,NNN® 
TE,CLO® 177732 G TE ,NOO#8 
IE.CNR® 177667 G IE,NSF® 
TE,CON® 177752 G TE,OFLs 
TE,DAAS 177776 G TE, ONPS 
TE.DAG® 177763 G IE,OVRs 
TE,OFus 177756 G IE,PRI® 
TE.DNA® 177771 G TE, RACS 
ITE.ONRe 177775 G TE, RATS 
IE,DUN® 177767 G TE, RAGS 
YE,0UP® 177707 G TE,RCN® 
TE,EQFs 177766 G TE, RERS 
IEEOT® 177702 G TE, RNM® 
TE,EOVs 177765 G TE, RSus 
TEeEXPe 177665 G TE, SOPs 
IE FEXs 177717 G TE,SNC# 
IE eFHE® 177705 G TE,SPC# 
IE,FOPs 177713 G TE,SQC# 
IEHFUs 177744 G TE,SRE® 
IE,HWRe 177772 G IE, STKs 
IE,1D0Us 177644 G TE, TMNe 
IE,JEFs 177637 G TE. TMOs 
IE,IFCs 177776 G IE ,ULN® 
« ABS, aveoae 880 
ABAGAY O01 


ERRORS DETECTED: 2@ 


FREE COREs 5669, WORDS 
eiPee [156,133] QIOMAC, YI 2 
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177747 
177726 
177640 
177776 
17764} 
1777a3 
177643 
177778 
177745 
177646 
177721 
177753 
177731 
177727 
177678 
177704 
177673 
177733 
177063 
177662 
177674 
177751 
177746 
177077 
177773 
177756 
177760 
177724 
177725 
177730 
177722 
177746 
177715 
177787 
177635 
177735 
177772 
177734 
177762 
177796 
177671 
177666 
177773 


OOHOKOXOGHODAOAOIOAO ADAG HAO OOAHO OH ASTAHAHOAHAAIAADHOGHAAIADAAIOHOGHOAOOHOOOSH 


TE ,UPNs 
TE, VERs 
IE ,wACs 
IE ,wATe 
TE wERe 
IE,WLKs 
IE,2Dys 
10,ACEe 
10, ACRs 
10,ACws 
10,40Ss 
10, aPCs 
TO, APVs 
IO,ATTs 
¥10,CASs 
10,C80s 
T0,C8Ne 
¥o,C80Os 
10,CCIs 
10,CCT« 
10,CINs 
10,CLNs 
16,CONs 
10,CPR= 
I0,CRCs 
10,CREs 
Io,CRJs 
10,CSMs 
10,CTIs 
10,CYLs 
10,CTRs 
10,0ACs 
10,0Cis 
10,0CTs 


10,0ELa 


10,0ETs 
10, vISs 
10,0TIs 
IO,ENAs 
10,E0Fs 
10,ESAe 
10,EXTs 
10, FOxs 


177777 
177774 
177743 
177741 
177737 
177764 
177720 
0807406 
8064090 
067000 
014008 
014600 
014018 
001426 
915420 
016520 
016516 
015516 
814006 
002460 
816500 
083480 
015406 
@15418 
061046 
812008 
015448 
016476 
015490 
816400 
615616 
010000 
0144980 
0024786 
0124600 
002000 
816000 
016080 
@96006 
083200 
0802588 
811400 
063820 


GHOHOHOVDVD GOA OO OG SAGO AO AGHAHHAGHEKAAGOG KH HO OGOHAOAGOGAGHOHOHOHAIHHHOHOHO 


IO,FNAs 
10,GLCs 
10,GLIs 
10,GNI® 
10,GRCa 
I0,GRIis 
T0,GRN®e8 
10, HOXs 
10,HIS=s 
IO.INL® 
10,I1TI®s 
I0,KILs 
IO,LEOs 
IO,LOVe 
IO,LTKs 
IO.MCSs 
IO,MOAs 
10,018 
10,4008 
IO,MLOs 
10,4008 
TO,MSOs 
10,RAL® 
IO, RATs 
10,RBCe 
10,RCis 
I0,RCVs 
10,RO0be8 
I0,RONs 
10,RELs 
YO,RHOS 
T0,RLbs 
T10,RLV8 
IQ, RNAS 
10,RNCe 
I0,RNEs 
I0.RNSs 
10,RPBs 
10,RTCs 
IO,RTIs 
10, RTKs 
I0,RV8e 
IO, RwDs 


004408 
816430 
016426 
016418 
216450 
016440 
0164608 
8863010 
815800 
802400 
217000 
BB0012 
0128608 
@v1010 
@68050 
013400 
216006 
814480 
815400 
206000 
203008 
2050008 
@21018 
213000 
203000 
0150008 
215008 
001200 
200022 
813400 
001016 
001080 
801180 
005400 
001040 
801026 
081020 
001040 
203400 
216408 
808060 
010408 
002400 


OGHOHOHOGHAHOHOOHOGAKCH HAD AHHH EOCOHON ASO OOOO HHO OGOAHAHGOGOOGHO HOH OOOOH 


10,RWUe 
10,R1Ce 
10, SA0e8 
10,3CSs 
10,30Is 
10,9008 
10,SECs 
10,SEMe 
10,SHT® 
10,SLO08 
10,SM0# 
10,SNMs 
10,SPe88 
10,SPFs 
10,SS08 
10,SST# 
10,STCs 
10,STPs 
10,SYNs 
10, TRMs 
T0,UNL® 
TO, wATs 
10, wLlBe 
10, WwLSe 
IO0,WLVs 
10, WwNS8 
TO, wPbe 
10,wV6e 
10,XMTs 
TO,XNA® 
1a,Q #8 
1Q,X 8 
IS,6V ® 
IS,CLRs 
I8S,CR s 
18,€S8Ce 
TS,PNO# 
I3,SEfs 
13,SP0s 
1S,Sucs 
QI, VER= 
SSMSG 8 
00 eGBLs 


002546 
002490 
804800 
013000 
013800 
012408 
882520 
062440 
@02410 
805400 
002560 
002450 
082426 
002448 
8044008 
062430 
062500 
016406 
003040 
Qb2410 
809042 
813406 
280400 
000410 
208500 
008420 
000440 
0110660 
014480 
614410 
820002 
880001 
800005 
008000 
066401 
015401 
068080 
880002 
008002 
O0O001 
800304 
080800 
0280001 


OHOGHLHOOGHGOAHOAOIG HOG OHO OGOOHSOAAKGGOHAHO OG HHHOGHHOHHOOO OO OW & 


APPENDIX D 


DIRECTIVE PARAMETER BLOCKS 


D.1 QUEUE I/0 
A 6- to 12-word DPB of the following format is used for the Queue I/O. 


wOe VU 2 VIC (U1,) «» DP8b SlZE (6-12), 
WD. Vl ee [/U FUNCLLIUN CUUE, 

wD. UL == LUN, 

wo. VS we LekW) & CRRLURLIYNI, 

wO. U4 #2 LADDKESS UF 1/U STATUS BLUCK), 
wOe UD ©" LL/U DUNE AST SERVICE ENTRY POINT), 
WU. YO = PARAMETER 81, 

wD. Us == PARAMETER 82, 

WO. LU ** PARAMETER 8&3, 

wo, ll 27 PAKAMeE eR 84, 

WUe 12 27° PARAMETER 85, 

wO.e. 13 => PARAMETER 80. 


D.2 QUEUE I/O AND WAIT 
A 6- to 12-word DPB of the following format is used. 


AU, VU == VIC (U3.) & UPd SIZt (0-12), 
Ae Vl == 1/U FUNCILUN CULE, 

WU. Ud == LUN, 

We VS 22 (hkl) w LPRIURIIY), 

WU. V4 *= LADDRESS UF 1/0 STATUS BLUCK), 
WU. VO 2 CL/U DUNE AST SERVICE ENTRY POLNI], 
NUD. VO ©° PAKAME LER 81, 

wD. VJ == PAKAMETER #2, 

WOe LV =] PAKAMEVER &3, 

WUe Ll ©" PARAMEL CR 84, 

ND. 1lé 27 PARAMETER 85, 

Vue 13 7" PARAMeITcRK 86. 


D.3 GET LUN INFORMATION 


wU. VU == DIC (Ud.) & UPB SIZE (3.), 
WU. Ul |2 LUN, 
WD. UZ ©" ADUKESS UF SIX*wURD BUFFER, 


D.4 ASSIGN LUN 


WU. VU e= DIC (U7,) & UPB SIZE (4.), 
WU. V1 "2° LUGICAL UN11 NUMBER, 

NU. UL "= PHYSICAL DEVICE NAmE, 

AU. V3 @" PHYSICAL DeViCre UNIT NUMBER, 


D.S5 ALTER PRIORITY 


A 4-word DPB 


NU. 
WD e 
WU e 
WU) « 


D.6 REQUEST 


A 7-word DPB 


whe 
ViU e 
ADe 
wD 
WU. 
WUe 
WO e 


D.7 EXECUTE 


A 7-word DPB 


WD» 
wUe 
WU. 
WU e 
Wie 
WU. 
WL). 


in 


D.8 SCHEDULE 


A 13-word 


WU. 
we 
WU. 
We 
WU. 
WW) 
WU. 
WU. 
NUD. 
WU. 
AU e 
WUe 
WU. 


the following format is used. 


DiC (VU¥.) & DPB SIZE (4.). 
FASK WAME (FIRST HAL’), 
TASK wAde (SECUND HALE). 
YASH PRLUKITY. 


the ‘following format is used. 


DiC C11.) ‘& UPB SIZE (7.), 

TASK NAME CRARST HALE), 

ZLASOK NAME (CSECUND HALF), 
LPAKTITLUN NAME (FIRST HALF)I, 
LPARLTILIUN NAME (SECUND HALE)), 
CPRIORIGY), 

tulC). 


the following format is used. 


DIC (13.).& UPB SIZE (7.), 

TASK WAME CFIKST HALE), 

TASK NAME (SECUND HALF), 
(PAKTITLUN NAME (FE LRST HALE)), 
LPARITATiUN NAME (SECUND HALF)], 
LPRLURAIYI, . 
tulC). 


DPB in the following format is used. 


UU 
Vi 
ve 
U3 


viC (15.) & UPB SIZE (13.), 

TASK NAME CFIRST HALE), 

TASK NAME (SECUND HALF), 
(PARTITION WAME (FIRST HALE JJ, 
LPARLIYLUN NAME (SeCUND hALEF)), 
LPRIURITY), 

Lulc], 

SCHEDULE HUUKS (0°23), 

SCHEDULE MLWUTES (0-59), 

oCHevube SECUNDS (UedY¥), 

SCHEDULE LICKS (0°59), 
LKE*SCHEDULE INTERVAL MAGNITUDE), 
(Ke"SCHRDULE INTERVAL UNITIS (1°4)). 


D.9 RUN 


An ll-word DPB in the following format is used. 


Wue VU 
wU. Ul 
WO. Ud 
WU. U3 
wD, U4 
WU. UD 
WUD. VO 
wO. 0/7 
wUe. Ly 
wUe 1Ll 
Wue 12 


D.10 SYNC 


VIC (17.2) & DPB SIZE (11.), 

TASK NAME CEFLKST HALF), 

TASK NAME (SECUND HALF), 
(PAKRTIITLUN NAME (FIRST HALE)), 
LPARGTITLON NAME (SECUND HALE)), 
(PRiURiVYI), 

tul¢c), 

SCHEDULE DELTA MAGNITUDE, 
SCHEDULE UbnLrA UNIS (1°94), 
(RE*SCHEDULE LNTEKVAL MAGNITUDE), 
LReeSCnkDULE LNiERVAL UNITS (1°4)]. 


A 12-word DPB in the following format is used. 


wb. VU 
wo. O1 
WU. Ud 
vb. U3 
WU. O04 
wO. US 
AU. Vo 
wO. U7 
woe 1U 
wD. ii 
wD. ld 
wo. 123 


D.11 MARK TIME 


A 5-word DPB 


wD. VY 
wD. V1 
WO. U2 
WD. U3 
we. U4 


D.12 CANCEL 


A 3-word DPB 
requests for 


WU. OU 
wUe. O1 
wD, Vd 


in 


DIC (19.) & DPB SIZE (12.), 

TASHA NAME (CELRST HALE), 

TASK NAMe (SECUND HALE), 
(PAKLITION NAME (CE LRST RALF)), 
LPARTaTiOn NAME (SECUND HALE )J, 
(PRIURITYI, 

(uiCl, 

SCHEVULE DELTA MAGNITUDE, 
SCHEDULE DELIA UNITS (14), 
SYNCHRUNIZATAUN UNATS (1-4), 
CRE@SCHEDULE INTERVAL MAGNILUDE), 
(ReE“SCnhEVULE LNTeRVAL UNLIS (1°4)). 


the following format is used. 


DIC (23.) & UPB Size (5.), 
(EVteNT FLAG NUMBER (EEN)I, 
TIMkt LNTERVAL MAGNITUDE, 
PiMe INTERVAL UNITS, 
(S¥STEM IRAP ENTRY PUINI), 


SCHEDULED REQUESTS 


the following format is used to cancel all 
indicated task. 


DIC (25.) & DPB SIZE (3.), 
SCHEDULED TASK NAME (FIRST HALF), 
SCHEDVULED TASK NAME (SECOND HALF). 


scheduled 


A 5-word DPB in the following format is used to cancel only those 
requests issued for an indicated task by an indicated task. 


wo. UY #-* LIC (25.) & Veo SIZE (5.2), 

Ae Vl w= SCHEVULED TASK NAMt (FIRST HALF), 
wO, UZ @* SCHEDULED TASK NAME (SECUNLD HALF), 
wo, V3 e* (SCHEDULER TASK NAME (FIRST HALE) ) 
wUe US ©? LOCHEDULER TASK NAMt (SECOND HALF) 


¢ 
). 
D-13 CANCEL MARK TIME REQUESTS 


A l-word DPB of the following format is used to cancel all Mark Time 
requests made by the issuing task. 


wUe VY ee VIC C2.) & VPB SIZE (1.).- 
A 3-word directive in the following format is used to cancel only 
Mark Time request made by the issuing task and that set an indicated 
event flag or cause an AST at an indicated location. 

AL, VU ULe (2/.) & Des S1Zk C30) 


WO, Ul e© LEVEN FLAG NUMBER (EEN)DI, 
WU, Ve @* LAST SEMVAICK KUUTINE ENTRY). 


D.14 CLEAR EVENT FLAG 
A 2-word DPB of the following format is used. 


WU, UU VIC (31.) & DPB SIZE (20), 
yUe Vi == cveNT FLAG NUMBER (eFiv). 


D.15 SET EVENT FLAG 
A 2-word DPB in the following format is used. 
WU. VV e* vat (33.2) & Ded Slde (2.), 
wOe. UL we? tvbNd FLAG NUMBER (EEN). 
D.16 DECLARE SIGNIFICANT EVENT 
A 2-word DPB of the following format is used to read an event flag, 
set an event flag, declare a significant event, and to report the 


pre-event flag polarity. 


ale VV ©" VIC (35.) & UP olde (2.), 
4D. Vi 7" BRVENL FLAG NUMBER (REN). 


A l-word DPB in the following format is used to declare a significant 
event. 


wW. VY = UIE (35.) & Verb SIldt (1.). 


D.17 READ EVENT FLAG 
A 2-word DPB of the following format is used. 


VWOe VY &f vICc ( 37.) » DPb SIZE (Ze), 
wO.e Ul |e EVEN FLAG NUMBER (EEN). 


D.18 READ ALL FLAGS 
A 2-word DPB of the following format is used. 


wOe VU 22 VIC (39.) & DPB Slob (2.2), 
woe Vl =" ADDKESS (CVIRIUAL) UF ofebILT bUrFFEK,. 


D.19 WAIT FOR SINGLE EVENT FLAG 
A 2-word DPB of the following format is used. 


wue VU ee DIG (41.) & VEHK SIZE (2é.), 
WOe Vl 7 EVENT FLAG NUMBERK (CERN). 


D.20 WAIT FOR LOGICAL OR OF FLAGS 


A 3-word DPB of the following format is used to wait for event flags 
of sets 0, l, 2, or 3. 


wD. UYU @* Vic (43.) w UPB Slde (3.), 
AD. Vl |= self INUDICATUR (OU, 1, 25 3), 
AD. UZ #2" SLALEEW FLAG MASK WURD, 


A 5-word DPB of the following format is used to wait for event flags 
of set 4. 


v0. VU 2-2 VIC (43.) & DPB Slée (9.2), 
WO. Ul 7" MASK wURU FUR FLAGS Lelo, 

WOe UE ** MASK WUKD FUR FLAGS 17°32, 
we US ** MASK wURD FUR FLAGS 33°46, 
SUe US |©* MASK WURD FUR FLAGS 49°64, 


D.21 WAIT FOR NEXT SIGNIFICANT EVENT 
A l-word DPB of the following format is used. 


WW. VU == VIC (49.) & DPse SIZE (1.). 


D.22 SUSPEND 
A l-word DPB of the following format is used. 


WO. VO #= DIC (45.) & DPB SIZE (1.). 


D.23 RESUME 
A 3-word DPB of the following format is used. 
w)W. VU w= DIC (4/.) & VPS SIZE (3.), 


wU. Ul -= TASK NAME CF LRST HALE), 
wOe UL ©= TASK NAME (SECUND HALF). 


D.24 EXIT 
A l-word DPB of the following format is used. 


WO. VU vr VIC (51.) & Deb SIZE (1.). 


D.25 EXITIF 
A 2-word DPB of the following format is used. 


We UW =" DIC (53.) & DPB SIZE (2.), 
WO. Yl == EVENT FLAG NUMBER. 


D.26 GET TIME PARAMETERS 
A 2-word DPB of the following format is used. 


WUe V1 == AUDRESO UF S=wURD BUFFER. 


D.27 GET TASK PARAMETERS 
A 2-word DPB of the following format is used. 


wU. UO == DIC (63.) & VPB SIZE (2.), 
WU. Ul == ADUKESS UF SIAIFEN wURD BUFFER. 


D.28 GET PARTITION PARAMETERS 
A 4-word DPB of the following format is used. 


WU. VU |©= VIC (65.) & VRB SLiZeE (4.), 

WWe Vl © LPAKTIILLON NAME (CF IKST HALF)], 
WO. UZ == [CRPARTITIUN NAME (SECOND HALE)], 
wO. VS ** ALDURESS Ur THREE wWURD BUFFER, 


D.29 GET COMMON BLOCK PARAMETERS 
A 4-word DPB of the following format is used. 


4D. UU "= DIC (6/7.) & UPB Side (4.), 

NU. Yl == CUMMUN BLOCK NAME (FLKST HALE), 
wWe U2 == CUMMUN BLUCK WAME (SECOND HALF), 
WUWe V3 @2 AVDRESS UF ELGHT WORD BUFFER, 


D.30 SEND DATA 


A 5- to 8-word DPB of the following format is used. 


wD. QU ©= DIC (71.) & DPB SIZE (5.°8.), 

woe Ul -™ RECEIVER TASK NAME (FIRST HALF), 
WD. UZ e= KRECELVER TASK NAME (SECOND HALF), 
WO. US s= ADDRESS OF DATA BLUCK, 

WD. U4 e° LEVENT FLAG NUMBER), 

WO. UD ©* (BUFFER SIZE = 1°255.], 

WOe VO 2? (CPRIURITY UF Send), 

we UJ s= LRECEIVER fl). 


D.31 SEND AND REQUEST OR RESUME 


A 9- to 12-word DPB of the following format is used. 


wD. VU -= VIC (73.) & UPB SIZE (9.°12.), 
WU. Yl == RECEIVER TASK NAME (FIRST HALF), 
WO. UZ te RECEIVER TASK NAME (SECOND HALE), 
WO. V3 22 LPARTITLUN NAME (CEILRSI HALFE)), 
ND. 04 7° LPARILIIUN NAME (SECOND HALF)), 
WO. YS == LPRIURIIYI, 

wU. Vo == (UIC), 

wD. U7 2] ADVRESS UF DATA BLUCK, 

WO. 10 "© LEVENT FLAG NUMBER), 

wUe Ll 22 (BUFFEK SIZE = 1°255.]), 

WO. 12 7 (PRIORITY UF Sewn), 

WU. 13 =] LRECEILVER Tid. 


D.32 RECEIVE DATA 
A 4- to 6-word DPB of the following format is used. 


wO. VY #2" VIC (75.) & DPB SIZE (4-6), 

WO. U1 =] (SENVER TASK NAME (FIRST HALF)), 
wD. UZ *@ [SENDER TASK NAME (SECOND HALF)), 
wU. V3 2- AVDRKESS UF SUFFER. 

WO. 04 © LBURFFER SIZE = 1°255,), 

wUe US #= (LUC. TU STUKE TI). 


D.33 RECEIVE DATA OR EXIT 
A 4- to 6-word DPB of the following format is used. 


WW. VV w= DIC (77.) & DPB SIZE (4-6), 

WD. Vl == LSENDER TASK WAME (FIRST HALE)), 
WD. UZ ** (SENDER PFASK NAME (SECOND HALF)), 
WD. V3 *° AVDORESS UF BUFFER. 

WO. U4 e© (BUFFER SIZE = 1°255.), 

wD. Ud -* LLUC. TU STURE 1). 


D.34 


A 4- to 6-word DPB of the following format is used. 


WU» badiens 
WO e 
we 
WD 
WU e 
WU e 


a@ 


D.35 ABORT 


A 3-word DPB 
vu 


U1 
Ve 


WU. 
We 
wl, 


RECEIVE DATA OR SUSPEND 


VIC (79.) & UPB SIGE (4°60), 


LSENDER TASK NAME (FIRST HALF)), 
LSENUVEK TASK WAME (SECUND HALF )), 


ADUKESS Ur BUFFER. 
LOUFFER oldb = 1ledd5eJ, 
(LUC. Tu ofVRE ITI). 


the following format is used. 


VIC (d3.) & Deb psilde (3.J), 
PASS wWAMe Ci LKSL HALF), 
TASK NAME (.:nCUND HALE). 


D.36 FIX-IN-MEMORY 


A 3-word DPB of 


w),. VY ee 
WU V1 
Wie U2 


D.37 UNFIX 


A 3-word DPB of 


UY #2 
vl 
Ue 


WU 
WU e 
WU. 


7 


D.38 DISABLE 


A 3-word DPB of 


UU =e 
vi 
V2 


WU. 
WUe 
WUe 


D.39 ENABLE 


A 3-word DPB of 
WU. 
WD » 
WU» 


UY 
Ud 
Ue 


the following format is used. 


bic (85.) & Urs SIZE C3.) 
TASK NAMe CRIRST HALE), 
fASK NAME (CSOeECUND HALF). 


the following format is used. 
VIC (e7.) & UPB SIZE (3.), 
[ASK NAME (Ck LRST HALF), 

TASK NAME (SECUND HALE). 


the following format is used. 


DIC (9Y1.) & UPS SIZE (3). 
TASK WAMe (RIRSOT HALE), 
TASK wAme (SkCQWD HALF). 


the following format is used. 


viC (93.) & Ved SLZe (3,), 
TASK wWAMe (FIRST HALF), 
TASH NAME (SECUND HALF). 


D.40 DISABLE CHECKPOINTING 
A l-word DPB of the following format is used. 


wb, VU == DIC (95.) & DPB SlZt (1.). 


D.41 ENABLE CHECKPOINTING 
A l-word DPB of the following format is used. 


wD. VU @= DIC (97,.) & UPB SIZE (1.). 


D.42 INHIBIT AST RECOGNITION 
A l-word DPB of the following format is used. 


woe VU f= YC (99.) & DPB SIZkE Ciede 


D.43 ENABLE AST RECOGNITION 
A l-word DPB of the following format is used. 


D.44 SPECIFY SST VECTOR TABLE FOR DEBUGGING AID 
A 3-word DPB of the following format is used. 
wD. VU e* DIC (103.) & DPB SIZe (3.), 


WU. Vl ee ADURESS UF SST VECIUR TABLE, 
WU. Ue ee NUMDER UF TABLE ENTRIES (8). 


D.45 SPECIFY SST VECTOR TABLE FOR TASK 
A 3-word DPB of the following format is used. 
wD. VU e= DIC (105.) & DPB SIZE (3.), 


Woe Vl |= ADURESS UF SOT vECTUR TABLE, 
Woe Ud 77 NUMBER UF LABLE CNGRIES (8). 


D.46 SPECIFY RECEIVE AST 
A 2-word DPB of the following format is used. 


WUWe Vl |* LAST SEKVICrR BENIKY PUINIJ. 


D.47 SPECIFY POWER FAIL AST 
A 2-word DPB of the following format is used. 


wUW, VI =e UIC (1U9.) & DPB SlZk (2.), 
WO. Vi w= [AST SERVICE ENTRY PULNT), 


D.48 SPECIFY FLOATING POINT EXCEPTION AST 
A 2-word DPB of the following format is used. 


wU,. UV ve DIC (111.) & DPB SIZE (2.), 
wUe Vi w= LAST SekViCe ENTRY POINT), 


D.49 AST SERVICE EXIT 
A l-word DPB of the following format is used. 


wO.e VU 2= VIC (115.) & DPS SIZE (1.). 


D.50 GET SENSE SWITCHES 
A l-word DPB of the following format is used. 


wU. VU v= DIC (125.) & UPB SIZE (1.). 


D.51 GET MCR COMMAND LINE 
A 4l-word DPB of the following format is used. 


wU. VU 2= LIC (12/.) & DEB SIZE (41.), 
AD. Vl =* FIRST wURD UF 8UeBYTE BUFFER, 


D-10 
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